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INTRODUCTION 


_ 1. INTRODUCTION 


t aoe 


| This manual describes the programming features of the UNIX system. 


It does not provide either a general overview of the UNIX system or 
details of the implementation of the system. 


This manual is divided into. four sections, some with sub-sections: 
@ 2. System Calls 
— 28. Standalone System Calls 
e 3. Subroutines 
— 3C. C and Assembler Library Routines 
— 38. Standard !/O Library Routines 
— 3M. Mathematical Library Routines 
— 3X. Miscellaneous Routines 
— 3F. Fortran Routines 
e 4. File Formats 
@ 5. Miscellaneous Facilities 


~. Section 2 (System Calls) describes the entries into the UNIX system 
_ kernel, including the C language interface. 


Section 2S (Standalone System Calis) describes standalone system 
calls, functions, and error numbers. 


Section 3 (Subroutines) describes the available subroutines. Their 
binary versions reside in various system libraries in the directories /lib 
and /usr/lib. See intro(8) for descriptions of these libraries and files 
where they are stored. 


Section 4 (File Formats) documents the structure of particular kinds 
of files. Files used by only one command are not included. (For 
example, the assembler’s intermediate files). In general, the C 
language struct declarations corresponding to these formats are 
found in the directories /usr/include and /usr/include/sys. 


Section 5 (Miscellaneous Facilities) contains a variety of things, 
including descriptions of character sets, macro packages, etc. 


Each section consists of independent entries of a page or so each. 
The name of the entry appears in the upper corners of its pages. 
Entries within each section are alphabetized, except for the 


~. introductory entry that begins each section. Some entries describe 
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several routines, commands, etc., and in such cases the entry 
appears only once, under its major name. 


All entries have a common format, not all of whose parts always 
appear: 


NAME gives the name(s) of the entry and briefly states its 
purpose. 


SYNOPSIS summarizes the program being described. A few 
conventions are used, particularly in Section 1 (Commands): 


Boldface strings are literals and are to be typed exactly 
as they appear. 


Italic strings usually represent substitutable prototypes 
and program names found elsewhere in the manual. 
(They are underlined in the typed versions of the entries.) 


Square brackets ([ ]) around an argument prototype 
indicate that the argument is optional. When an 
argument prototype is given as name or file, it always 
refers to a file name. 


Ellipses (...) are used to show that the previous argument 
prototype might be repeated. 


A final convention is used by itself. An argument 
beginning with a minus (—), plus (+), or equal sign (=) is 
often a flag argument, even if it appears in a position 
where a file name could appear. Therefore, it is unwise 
to have files whose names begin with —, +, or =. 


DESCRIPTION discusses the subject at hand. 
FILES gives the file names that are built into the program. 
SEE ALSO gives pointers to related information. 


DIAGNOSTICS discusses the diagnostic indications that might 
be produced. Self-explanatory messages are not listed. 


WARNINGS points out potential pitfalls. 


BUGS gives known bugs, and sometimes, deficiencies. 
Occasionally the suggested fix is also described. 


A table of contents precedes the first section. On most systems, all 
entries are available on-line via the man(1) command. 
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“—"_ 4. COMMANDS AND APPLICATION PROGRAMS 
1. COMMANDS AND APPLICATION PROGRAMS 


HERO a cichssenlonsspriadecesranansi introduction to commands and application programs 

BOO scececkitelihedinseseetisets handle special functions of DAS! 300 and 300s terminals 

BONG se ericidisiciectwcavaliatooeudivisuaecdien paginator for the TEKTRONIX 4014 terminal 

ADO asec Beseieciaeritneaeacaatviwes handle special functions of the DASI 450 terminal 

ACCICOM sciiesdecsczevicchcasieesatecereesesznne search and print process accounting file(s) 

UD ieecsssncceccaticcncecadaletierhiecedususseaweasircad ue co usndctnadenteossstaueateneate absolute debugger 

ITM ose cpeliecccpadanse vee sects dos cocncnveteewtasssacourssaseeesues create and administer SCCS files 

OE einen cee aveusieescisteeae ener: archive and library maintainer for portable archives 

AICV ........c00s0000006..cONVErt archive files from PDP-11 to common archive format 

RS sis hvgade coe sccneasveaweteuseceusineeteukstekerk ii eeneaste west canbeccanouecuswanscevaens common assembler 

SE caseaics acd ssecesusicop nectssasuudenmiscongudevecoeee) interpret ASA carriage control characters 

OY os chccicwedevceeden vant luce cede satus sheet ex bse vuleueseneseanucovete execute commands at a later time 

AWK cccaiesancanertctenenesaasectwtswausenoetenebene pattern scanning and processing language 

PMO ices sis oscc auc tae dice the conctevtcnlwetescedesancamaveveboaarcewatcanuacsdaseessscanss make posters 

DOM oo vessiecauina dan geceetialsecesicecedees Cusnaneustbea len. Berkeley archive and library maintainer 

DASONAING eins cudictecrendsn sis svesseieestcctacereeweosastivetnws deliver portions of path names 

DD AING Rye o ses cicca ton san steauteadeerosen ss daceueermiessbaceciawensseees print large banner on printer 

BG oes toss us neds ected coes sae Maen eeakeasbeseca seeeedantk arbitrary-precision arithmetic language 

DIU ireceaeis ceca ees ean tenuis tes Seema vetoutesves covahndaveissuneusvans vaeseetaceseudteniouvabencteeeese big diff 

PONS oa setcccceveccaeaceasecaspveee a axecanieeb oa suaehsaueeeadasaunasaepawassecehreascenseeactoans big file scanner 
_ Diss cecn) cee I dutos de veneausbtesosasvecticsas Vaageadsanoceaceuseea list contents of directory 
: DG corceeeicexeteteessiyeses ade oeatoes a compiler/interpreter for modest-sized programs 
7 | ESS Re ISN a neat ee OL Ene ne OR eT ee print calendar 
COlONGAR aides cagece cose caticyasccauesietanawicsteecenaqiecscuih eanctenaetvousveastemedeerss reminder service 

CAs ii scssaisiaternetiintn asserts Aes concatenate and print files 

Ds eco yeusse ese ausuers emetic hanteaeetnace seman vent ooueete nts C program beautifier 

sO sie eiasecied cascade seeecetuepet aoe caeceesene pass or vaceuchusias ounauceaiueataseayetereas Sssuas: C compiler 

CO earavsa ce tesiec da cache cececate ee a ccetansiebuceverauseoctsdeplanvciev ome: change working directory 

OOG iscinsig ds ncctecavasiescieeceavenciacetence change the delta commentary of an SCCS delta 

CTO Wao soiiosescseeisea Ne ecdeaaente lec e esekenc ea aes generate C flow graph 

CPO estes Foes esas ccs ie Sa eds woes acancu la soevea ede sueensaceaveseveusesacconeee change mode 

NOW ss csiccesc creas ccsacvaiwiawcsanecced sosnscueceiencienoaawedotaaeeeieccens change owner or group 

CNOA iis caccdecaatietaaves teteaduncesentceee soviet aed ich etiwatinneeeee clear terminal screen 

TIN eicnstca sen slauaiseceeasie seas anceacausacuances ws auanmeteuennecs cos iagwenesectane vee weatees compare two files 

CON acaiscaucanicceaveidnnaucencac caus daana nese ebianeesadotansaavaestacerecencsquoactes filter reverse line-feeds 

COD ss tasciasirunncc oneness iees nsec eeieidivbsd dere aaa Nace combine SCCS deltas 

COMM cca ahs tieatieareees select or reject lines common to two sorted files 

SD seasick se badaepad xcs neues ke Saco oegaacaea usu taeusonnan tetas rece tvtetusenmesanees copy, link or move files 

fo] 0) Ce JEAe eae Erte na ae ery ERE ener rae Se ereer aR ar nN e rere copy file archives in and out 

ODD cczessapceaceciticsncctecvotsicceetecs sigue ubeeieassiusbansiseseiesedes the C language preprocessor 

CROP 5 i5spas sedis cxsaves cetacean su iuanncwencetaetes ee acbs cesta saencueuee notseereacesnnse user crontab file 

CPD rac eaciecies cianacens ces eraet cattctacedenindecebeceesaa cess saucoes acne ea saeteneateens encode/decode 

CSU viata vicsncstisacasdeeiinsiccieeelwaeee a shell (command interpreter) with C-like syntax 

CSPI ahceeosnceh cece ceca iarsae cise ssece ecsevacendenav sanencoemaneaoicnameaneeartueeeniee context split 

ON wooecatevaedsauivacvvanwnedierdenct Geacoxesv esate iss peeuncusenseetess spawn getty to a remote terminal 

ae CU etisedeniyeassacwteaneuissiess steaieessearteueelsteuacrneeunains spawn getty to a remote terminal 
( CLAS oo scpawcisctss oss Bosewaaceiee acuvaw ec iieuiae nese eias se Covsaes etedeadetuadsiusaapacsceaee create a tags file 
pO: | ol = en nen ne eR Ee ne coer SOR a eee ere treme ere C program debugger 
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Cie. sess Soo ansisd sisca tat eich teas eet ae .call another UNIX system 
Cie sce at ads Aveeiee sdeta cvaue dacec or ciietatee nas waned wat abeeveea sect eoteveceivee niet call another UNIX system 
CU tastiest eanisaetesceuseeaemeeisaieneis cut out selected fields of each line of a file 
CXIGE Aint ea ire dig ieee cctv generate C program cross-reference 
CO ac orceve voces seca uate tes tae sanac ence ccteoaa eek eeuane as eee een print and set the date 
Co [= ea Rc a oe eRe Se RCL me Pe AC en eC ne Ser eee eee desk calculator 
OND casos arate ersvettereeGir nua toe cca nomuct wmesacuuse ss snceoncedeeaeyacen ence convert and copy a file 
OTC casi secon aecstekccceciccccaaecharctacaduccusestewesiins make a delta (change) to an SCCS file 
MOC LOU 25.cossbiinevtracecsaveqcscetatinartieussereiens remove nroff/troff, tbl, and eqn constructs 
CORA eh ise saececeeeeceiies os cae nalteenatei een deketnaucenbeccanecaseees dial a Racal-Vadic 3451 modem 
CRETE scseicepacusccnCe suceeiceuedawasevi udu dues Sencenees tasetieseceseenicenooanealben’ differential file comparator 
CUTE S essgectncs eis cciis sesdatesdotuean des tenchosanatsecebaceaanenteree 3-way differential file comparison 
CNA wien Sasi cccinnsesueiacscucuot esuasassecanseeesssncandetencadesiuas mark differences between files 
COURT dies teeee aca eet Baccuecaccanco sei eneca te bonewenns des endecaes isi deveses directory comparison 
UN yas Secacaevaheis Ve atecenc esta cewiade eiechstnanseecseese easy ee uc eees summarize disk usage 
CUI eccsicsiiesi es evens de eevarsecientee cider aneusinieeinss dump selected parts of an object file 
X99 100 viducsccissesecrssoenescueessare: prepare troff documents for the Xerox 9700 printer 
CN so srs cacenanecagstaceucd acon beuteatucseu eves danaanoesdeetusasnanisansiereatesatanes echo arguments 

Oeics a coiinu is case uo aucen ea hua beac vawe Saaveneccan boduaescnsencdsaske cis eaaie enemas text editor 
Ye | | eae ee rene ere nee re ee ane ST text editor (variant of ex for casual users) 
Ue ceaderossissaca setae tusesacvslibecausausnioiwieceucuseisendasceiteccessiertan Extended Fortran Language 
GNIS ss se scavecesseckesvsevecisvacdisnesasctvonsc Aaeai vaszeveuaearsetasinees enable/disable LP printers: 
BUY eacieeecedecces eds eeecbcaiviaeaeaaeeaasaereets set environment for command execution 
Eqn........... ee Lapanddedadokasteoueesateeeiadse: format mathematical text for nroff or troff 
ON ors cosnecctesirsenvouyaaetteeau cee eceuacee oe snpudvacaustion vavursetoscacenceecoageaeereunereacs scares eeseaes text editor 
OX DF sedecsicteicbecerctecesciene ianedoceta ucecancsusenenguee evaluate arguments as an expression 
UU sii esccapedectus bin as rignenieAtisciecewe case eassenenes aak euecapaeaesee anes ates Fortran 77 compiler 
TACUOP Secs peo vayicg te caret enaawutnev edd iivaseistiwedcnatigeer dea sancne cern sicneadeseton wees factor a number 
TINS castes iis ata check cearel tse tvance roe aesvtaa cans oes santa ewteveta reas determine file type 
WUE oscccisiss semesters Secs oasina Ne aioe ces eee eSs ati ano oetncwratasiuenn va cnuas ioe bd des extmonie conety oxen tuens find files 
PSP coseccsiwiavitawsnescesveunidonicsetccteseens dcoanisaclacasvxussvessniaenens split f77, ratfor, or efl files 
GOO ei ierisbieciwurrauchusaceavedeeeecntaancieeransviceacat graphical device routines and filters 
COO ees iss dtas ec ccat aicacaresinbiucewenueeacucaseatien graphical device routines and filters 
LO arctic vase aviouies caetctevenan sesiaevencesnsacsek cane yoceseurchetuak vesaaiwe ee soanvese graphical editor 
SOG cdc te5o hace caieslen dest es uatenlext as ven tuctvsacbauntonenbausdu se ssedvtecuauaesleetercatee graphical editor 
get........ b eadeulae wale ubcs sas anaetesstats Revenue enssacsaeltecsaeyeunieoenvse get a version of an SCCS file 
QOLO DE cic orsacsetacered eg cies coesde vous lise titiadeactacenescisvereaneete parse command options 
GUE oeoshewiudecitesmesnvecsunescctuisewedives isevacccusiecleetia aautuesei enti ereeasniaee draw a graph 
Qi EI s cesssvasenatecs tipetsateteicsaccnieivciwaacetie tun nauetsssiaerieldsttededseuateuaueauiiess ss draw a graph 
QIADNIICS veiccssccctsssnscesmeatcerteneetosiios access graphical and numerical commands 
OPA PNICS vesscisisicecucsernesiczecicnseecennes access graphical and numerical commands 
CEG BG ic auseaniaiicedoicsvcccesceduatawasietewucyensses mireabadesasnedeveauddravenmeawenael select terminal filter 
PO ioe saioic asic bashed coneniea ue eacaascioseauesewsawes daloies search a file for a pattern 
Ce (| nee eee oe Ann? mR Tere er ery Per nee Pere graphical utilities 
gutil.............. aise dic eae websin os end tetas descaie nesuccudetonethasuy vaqueanadeaconcu: graphical utilities 
NG AG iveitinstctvavctansers voted SeiterteownS zits aidensbatactecaretea ieee? give first few lines of a stream 
INQ ND assesses sae caa cen ccaceaecosvanemewncsade anecevacnedusealalwaa gauss uses uaasaaaguatiaeanersacaseuiees ask for help 
Li pene cero handle special functions of HP 2640 and 2621-series terminals 
UNDOING ics naan eed sn veinacnea sees Wea chena snd aaa eruekae find hyphenated words 
NO oiiswasoae Sos aheess waves Nona dolave leviulexire vonenedsectsoes print user and group IDs and names 
IPCIM.........00000- remove a message queue, semaphore set or shared memory id 
HDCS oo sorvic doen cssicresetenieletoses report inter-process communication facilities status 
DOV cosa doc cashed etsesss Soa veieess btn tees pan vate eomamaaunes eatees et eteone relational database operator 
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HUD sista aceeewecdnestutacuanads oon suensesawnsadesdeceraasaaatecmusaamaeseseneauisectanaaees terminate a process 
UP picstiecakivig Soca peuatencseraanesoweyseeupesecdescisxeeelaesiaes link editor for common object files 
NOK ssc ree lnave ieee ro osbic baw coesesaseraae generate programs for simple lexical tasks 
TEENS oars se cles cere canuctacu sia vaseucduatieaneancousideasesnieavetadeenammetintuecsusaes eats read one line 
DUNNE casein ee fo astra areca caves see hacca ta esa pea eeee sian ncueieedeleceseaesouice-e a C program checker 
NON sce ciek es cee cea ciats Setcsecow sansa eu es waseseaitaa nlc tana ven eae estaten noise mnscu encoun ncumaxe sign on 
TO GEN AINIG Faischscoscesececvesacnetedcadececsaacinewenes wears achiceuacnateus Wesiaedacs aeetute wees get login name 
LO FOIOR acess gvcai setvavndcrcovescseeceerenssceecestues find ordering relation for an object library 
NBD cco ectecccnacdeawcuetaetapieurs sevevseuchendesectancaee send/cancel requests to an LP line printer 
[fe] a%e) (= nace ae nse ee enn rt tment ey atcha ee Seen eee eae postpone printing, resume printing 
NSU acaba crea vier sasievine coax tetediweieicneceelente desist print LP status information 
DS edicane sie Gratceu aleyoediuacdackucucesoecoees causes uetsavaccon aces eeteuia ane list contents of directory 
ING a leccepsntuseunsvansetnnndsvivansseacescssvsasiseswadsas Vous uatpeisussyevesiendedinecetsauce macro processor 
FAC I OE oo sionds ccivecedoeniedevessoinesacnsiatess produce cross-reference listing of macro files 
EVV oats ecennlescaes age acc ecincnavsuedeesieciasianceansennsmondeneiease send mail to users or read mail 
PV QUUX osococ oncec neuen cncecy, Set vealastpanasyscswunseodouees interactive message processing system 
PAG seiyaie seczataeesnceGivink. maintain, update, and regenerate groups of programs 
PM AKO KC Y ecsceices iscdu dahon estianiadsutawosdioeciaciwiepivewenedetancerieesstees generate encryption key 
PI esas isiceed esl Sacawnep ects ceca esi ieee ace ee print entries in this manual 
PIO SG eae aces wa lecvatectectansaversccereeionreisl Mareinaee meietuneee permit or deny messages 
WIAD, isis gsiicweink a cave cas iseeinde veddeea aceyoaseuiadasiehssduaheanceteetancateetceaasesaessal AKG a OIeCLOLy 
WS UP ss citeecteisnciousevescedscseeas create an error message file by massaging C source 
BPN sce incasinaviccevicys Seittieeawesa print/check documents formatted with the MM macros 
MINNA 5355.3 ce sroff/MM nroff/MM document compatibility checker 
PIVINI spd gescecdacicdsvssbctepsadieeasncacceasnuastenen typeset documents, viewgraphs, and slides 
DUNO FG sooicsisss econ cdcways cacy acct venice vduchawabedereoss detaen file perusal filter for crt viewing 
PO WE O RIN sissies eerie essree to ae ieee tesiecice seals change the format of a text file 
ROWE oaiscsssti otis sche Sess ec dewhc creas ie iia eaweccsaetenenanpeneeie thes log in to a new group 
OWS sack icae case deecios Gite ewcdlwan ss tacauduaet canesinctadadtoceauacanteaaanasetaccasantt print news items 
PCO sciscasccceecoitennatesercamannatacvotsecwe deeatoswvolocseneseaatevete run a command at low priority 
IU ceca cisies seuncetaaceccuees sbewaeon seanmeaabcteneeeasssccrnaneusaueaaanecaeua nave line numbering filter 
OMEWD etek ecpesiceaipsuses sci vsmacesensa ven eheataecasnastcershs print name list of common object file 
NONUD cpcccisnscicessectwete, paieiccusuesta run a command immune to hangups and quits 
PUR OTE 5 hvac cat esate nthe sage se eeteee ts te uesan caasew eaneoaatetereteas east format or typeset text . 
OCW... ..ccccsnceeee Sidi damciestwanmudecy vos udansevecembnceans prepare constant-width text for otroff 
OD vest oras cue an sicatens deivesyaoaimnave na seinne ten caednesaie es tbie sd eseueaecnest ice mags aues Cla GUIMPp 
DAG ai cscctsscsasets cepewicneaeliucauebeanidauesaveeciveniacueuastaceanases compress and expand files 
PAS SW essence tacvcsueccvenacssaeeacaneoistescabcnseetrceesenane arose change login password 
paste............... merge same lines of several files or subsequent lines of one file 
POG ccc enero vars castncal ceieaeouneiteins sewteseniios file perusal filter for soft-copy terminals 
DIG Jeseccscnatiaxiacsecsavvensveiteteesannsiwens troff preprocessor for drawing simple pictures 
OR oes eaiceadeaeuccaghacecunccuusuas ead veueuuyea states euaue ce tus ecuneees moans cuaeebinemmcdiamncene: print files 
PERO NV seco cs ors rene esas seen Seen ceili nbe Sete edeseee tee tases: print out the environment 
DONO 0 oss ea steve seeeautcatin tones doses acta aa ensaeewnves sventenanany sav paneunateconciees display profile data 
PONS aasiacacics serpaueeTewesl vennacsedaatalue wedeesdecautsesaetccsmerieuuseeceneueeetp areas print an SCCS file 
OS os ves siereccc wate sbacus cycus oa venacaepeuesevoreieneaesenmnaentcmnieeetsdmantuaess report process status 
DOUG dase atacenetesentedetawieuiauieticeas cused acoesvdvs er enasessasuaet devuaentuecsuanwetusimusenees permuted index 
WG ec ccics tacnacsctité case teredinabadssevebecnesa comin dptun oeancncteatpaeaeeteas working directory name 
MUO Fasc Ga sucty swsaits caves 2a boouse oe tes! ccoua ete wescanuedeupeicaanweuentaunaeenies rational Fortran dialect 
POG CIAD es ticncsepcidanrCvalerticeconcaovestacveiisseences tesa ueeadeans regular expression compile 
WVU sade sdaisirecaies Vee auven eu lectouesanivsansessiaanorieubo ee aneeeeretaas: remove files or directories 
BINNION oss caseayvoredoenansveetesteccradeacveuvescawsncunuseeee neues remove a delta from an SCCS file 
SAC Gosia deweniase ccs ccsanceeticcnccecsevatevasdveueetaccetiviees print current SCCS file editing activity 
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SAG a sasesocstcacacenstecevi cs tetwsavasetevencandeceaiaw aces tevecvervanscbovsenvenaseeass system activity graph 
SMG vse sacar asad waar Fo aoa en tees nes bute neesevons eta system activity graph 
SAU ys scock cules icasoiancsestacc caus to cloceunuecoiecasdncerstacdecesoteds sacks weareees system activity reporter 
SOG recs ceased yonnved odedesececuousonvetseceanseotecteueawaes C compiler for stand-alone programs 
SCCSOINE si ssecentsevccarasseetusetebesetecsiueeioenewen compare two versions of an SCCS file 
SCHIPt...........ccccsceeescesetcseccssceterccesresssesssesseseesttiake typescript of terminal session 
SGU vronssavisiecaccGatietnataaenseasene reese nae: side-by-side difference program 
SO Sais piscine Gtcns cewoenin cma nnn une eiesanvanseneaanice saa ensaeacdeateatees sun teutexouabeuunesses stream editor 
Scie vicscetevctece: shell, the standard/restricted command programming language 
SIZG ii cracusti die tirtcitucis aimed print section sizes of common object files 
SIOG Dass oc cs ceezicstisesencentedenie wansaucasseersectassiabacdetee suspend execution for an interval 
SING sis Saas cas ea opin eene ece ecm vns g uae eae ce epans eoenevanc es earaseeconasuanieas SNOBOL interpreter 
SOM isco vive dene veussccccansvensen vasa veuuseessesaceesanveseserenoseecuevsseeanes sort and/or merge files 
Se Mae canca da sheechanstic eas Celedaeceeeawtaauserese rece anaes anaes eee find speiling errors 
SPU 5 wis suena dec ives sues Save vices nansavetesauddexanvecyev te weudeveranieceiese interpolate smooth curve 
SPURT 55s cre ase See anaes interpolate smooth curve 
SUG seta os aceraace va htc ecetstars eaten sateeceles Scodeustvetiesecet split a file into pieces 
SHOT cess vacavancesudesceasssveedscawadeusaceassansscnecascacvesacaeedien uss lndatacsmeavenad tvives nvete format text 
Staleieenratea ae Statistical network useful with graphical commands 
SUSE oi issinccstieniern terseatioe: statistical network useful with graphical commands 
SUIiNS ............sscceeeeeeee find the printable strings in a object, or other binary, file 
SUID scssce strip symbol and line number information from common object file 
SUEY ss seoeicestys cacteseniavela acca cnc venteeacevsneusttasabessdonsaetoetee set the options for a terminal 
Style ........... ue aeeautnaeusieaencse@esteceves analyze surface characteristics of a document 
SU cscteed snes ssacepdantcescaasa bi avtecccauisnesteias eens vas eiens become super-user or another user 
SUI a cyies aes oa wate etastenceeeeceasvicuaeeeceec print checksum and block count of a file 
SVC oe cedaieciceccunetettusswaas suc venouasacwesaucse yavesvexcsusiuadeeeesemecnves update the super block 
TADS cicnuiesc telex idadicivocanudadtasteuniuieusvensacents tectderecscs Hever easadiecs set tabs on a terminal 
RAIL sg scteusces ac Ceadavesbnabuaccuauansutcupaes dedeereusscacudeetuectenneortes deliver the last part of a file 
RRS eases esos ees hac Le ken tew cuentas aeut eas Cone paws euaniauunsntioedotweridacuse: tape manipulation 
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ustat....... cnudandeeie Uetuaeusdeeateniadta tous vavnus uiesddeeayandledecaieegateciven: get file system statistics 
WEE oiccsc oxic cut icntecsaiecsuaveuss ccaucedocnadcustoneseevaenaes catssecanesouileceatensucestsneuies write on a file 


3. SUBROUTINES 
3C and 3S. C AND ASSEMBLER, STANDARD I/O LIBRARY ROUTINES 


BILE ooo oesed oes teveriracsvabenel disaceees Diels introduction to subroutines and libraries 

| suvsvetereniss convert between long integer and base-64 ASCII string 
DORE sap satccs cect caasagedecedeiea bencdcccisiuars acaba cee daccea sie tasaviusenansieans generate an IOT fault 

PS oe cscs eictors tunieacecutoedacwexceceesutsaiuevseereueart sateesetetevenents return integer absolute value 
DSCAIGCN iecsecisssccscctcrescaskescvassecsvsesis paseeceiadennvisesevesdees binary search a sorted table 
CIOCK, sacvasicersnuasasansieanesuoceaciencacdsntansdabsececaneveuncevnsedeazasperhuacaien report CPU time used 
CONV.......00 avedacee Daina wduuavantenie aaah stu viion eas wan desu cdestaamdbectveuaeestenes translate characters 

SHY DE oi csvraawscaywecies tases wenacencscnsesetcenntvesvessvasoas eeonessaaeseseeneds generate DES encryption 
CEOMTIIG .........ccscrscessrerrsnnnenssanccensnsanesansccerensecserenas generate file name for terminal = =—~ 
CUNO occas ois cae sicetueessssvesncccens Stauabevabbeathuboaseuautiaasys convert date and time to string 
CUO aires ornate ecncce ce tends beat doa savane tbat a eve cat oeteeebeme vec seees classify characters 
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GCUSO NIG i cx ievicccsszccedevsecaesedccseecias enneoeeedecsaee get character login name of the user 
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drand4..................00. generate uniformly distributed pseudo-random numbers 
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( WANG Css o coc siceceseesersacaesseese esate main memory allocator 
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EG 1) © REE Cerone Pine eS ee ry REET NO RR oe ORE nT a Me Saar re RE Snare non-local goto 

SIS OD ioe so sceiecces sicseieceoddasen ton Pine eee suspend execution for interval 

SSH 4 sesdis icoteccses piceacscaiew cocneaiawnie a ee hanes software signals 

MUGIO ssasde ca cssseeivaiat sdtwaacireevactierds casey enen standard buffered input/output package 
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SUNN cesses sce ctweenwacies sven sabucivicss nensnt is coes ven tevnns oat eetaadeeecureeneedvens: string operations 
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a SUSE TUN 5c suisse iss Osanna Soa tees hatin de ed uatie seantse: issue a shell command 
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3F. FORTRAN ROUTINES 
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GCOS. oaveecopadce ia wecniaceaedtuaveineonteerosemeienieatets Fortran arccosine intrinsic function 
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SIN cisions rcuclea duct ya Coca asea Swaevneues eaves caeeesseaseeebees Fortran arcsine intrinsic function 
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RAD eocesiarcscceeicaivousicies desussescinysvodasoeelsauseartneeuauees Fortran tangent intrinsic function 
ROI eseess esecestee ieee es cease Fortran hyperbolic tangent intrinsic function 


DINE hss cscs catia evens poss penen tet et vedeoteataciavereameetteetsurepsurent introduction to file formats 
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DOU sadidccacvarenossces op cea shane sevacecanecanasedeseceueesusacuneseadivasWensecwiecs IMSP cartridge controller 
UW ev ccesiesnacdiwin cesta te ies tetoeeen es ereare sian cecs cess Cipher Microstreamer tape drive 
WU AUIY ocdaceeree ce beas Oakes eraueeexdeacnconeectesteeaitundavens allows memory to be used as a disk 
RE soso od sacsccu cose laachssaulcceaniciaseneseavedeaceccsctusxscuanueaevined: general terminal interface 


8. SYSTEM MAINTENANCE AND STANDALONE PROCEDURES 


SDE onezocs cos ecatsacederettants aviaeoevaes introduction to system maintenance procedures 
COE suse sesaacce radian Gak endenectnine tens ssosasasdepeustacasberenceaseanasnes concatenate and print files 
CHAS We css scccecs or cacasseuraetsnanedeueiccuausaceatsevesesncos what to do when the system crashes 
dconfig......... wid GualusseaCabaiicauetes ccaussavatna dadoese astra secu co ndsaueed configure logical disks 
Gh sais iaccuei ees tiswideadaeeas ces tiaaeinceeoban cous casted antsanbnadesdeueaauaesetaies convert and copy a file 
OE OLIN is sce os sas scaccee rss eset Seek aap aoe woes sans nes oa eco aoa en nee anes disk formatter 
UD seca irovavas sev esustesiecitecondaddeuuaaoueeeess dédeniatudoversseueanceaesacdevetees summarize disk usage 
TD AGC UD ea riccacenwsasstisscevicesrkeenedesteiaiea dh make a fast tape backup of a file system 
TSO iosccuis cosas Savereeedeeeneess file system consistency check and interactive repair 
DSO oes saad ceree recov hte oo pane etacaneceendoushenevausbeestaeedascececeudeact file system debugger 
FNS UD i soancsacseccechipisssutisnidaatisetivataw sh ced awis ex needieae dace nepas eeecada oui raetedeges tees ask for help 
NS sic Sse tecane Vaile t ae teas ek ceca nalun ves euieiaectmeseadia exeusauestewedored list contents of directories 
BVT Sarasin oe esas cas seemed acdsee sea waeen cakes vee estaceanaes construct a file system 
Ob ceeds cad ru css walei cain dicta tas ea ca a ae cave ew aw ea ew eee eceaaaee octal dump 
PO SLOG scasascs cacacaoccesacesecsicesssaasaviis vevianeeuaedcesseamsauies incremental file system restore 
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(change) to an SCCS file delta 0.0.0.0... delta(1) 
(variant of ex for casual users) .............. edit(1) 
letc/sys System control and .............. sys(im) 
1 if specified file descriptor is 0.0.0.0... isatty(2s) 
2640 and 2621-series terminals hop ....... hp(1) 
3-way differential file 0. diff3(1) 
300 and 300s terminals 300 ....0...0.0.. 300(1) 
SADT MOGS IN essaserseit ctor hancreumienneeiass dial(1) 
4014 Paginator 0.0... eeceeetcceeneeeeees 4014(1) 
450 handle special functions ................. 450(1) 
TH COMDUBE TET scwidossiiciventiticatoscssir avers f77(1) 
9700 printer dx9700 prepare ............ dx9700(1) 
9700 printer x9700 prepare oo... x9700(1) 
ASA carriage control characters ............ asa(1) 
Advanced Communication... acpdmp(1m) 
Berkeley archive and library ................. bar(1) 

GS COM PIGr CC aii ecscarsioriencacesittalontestes cc(1) 

C compiler for stand-alone ............ scc(1) 

C flow graph CHOW .......ceeeceeeeen cflow(1) 
C language preprocessor cpp ...... ......... cpp(1) 

C program beautifier cb .........0000.. denote cb(1) 

C program checker lint oo... ee lint(1) 


C program cross-reference cxref ........... cxref(1) 


C program debugger ctrace ............0.6. Cctrace(1) 
CPU time used CIOCK oo... ee clock(3C) 
CRT screen handling and ......... curses(3X) 
Cipher Microstreamer tape drive ............ rm(7) 
Communication acpdmp ......... ee acpdmp(1m) 
Communications Processor .............0. icp(7) 
DASI 450 terminal 450 0. eee 450(1) 
DES encryption Crypt ....... cece cseeenees crypt(3C) 
EOT on the other terminal and .............. write(1) 
Euclidean distance function hypot ......... hypot(3M) 
Extended Fortran Lanquage efl ............. efi(1) 
Fortran 77 compiler €77 oo... eee ceseeeees f77(1) 
Fortran Language eff... cece eee efl(1) 
Fortran absolute value abs .............0. abs(3F) 
Fortran action on receipt of a «0... signal(3F) 
Fortran arccosine intrinsic. .......... Suen acos(3F) 
Fortran arcsine intrinsic... eee asin(3F) 
Fortran arctangent intrinsic .................06 atan2(3F) 
Fortran arctangert intrinsic ......... atan(3F) 
Fortran bitwise boolean ou... eee bool(3F) 
Fortran command-line argument ............ getarc(3F) 
Fortran common logarithm .......... log10(3F) 
Fortran complex conjugate ........... conjg(3F) 
Fortran cosine intrinsic ........ eee cos(3F) 
Fortran dialect ratfor 00... cence ratfor(1) 
Fortran environment variable ................. getenv(3F) 
Fortran exponential intrinsic ........0..0... exp(3F) 
Fortran hyperbolic cosine. ou... cosh(3F) 
Fortran hyperbolic sine intrinsic ............. sinh(3F) 
Fortran hyperbolic tangent ......0....0.. tanh(3F) 
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functions mod 

sin 

function sqrt 

return length of 
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print user and group 
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set user and group 

pt 
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generate an 
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Processor icp 
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abbreviations file 

commands 
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enable/disable 
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configure the 
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Extended Fortran 

documents mm the 
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change the delta commentary of an 
| combine 
make a delta (change) to an 
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Fortran imaginary part of... aimag(3F) 
Fortran integer part intrinsic ..............0. aint(3F) 


Fortran maximum-value functions .......... max(3F) 
Fortran minimum-value functions ........... min(3F) 
Fortran natural logarithm oo... eee log(3F) 
Fortran nearest integer «0... round(3F) 


Fortran program abort oe abort(3F) 


Fortran remaindering intrinsic ................. mod(3F) 
Fortran sine intrinsic function .........00..... sin(3F) 
Fortran square root intrinsic ................. sqrt(3F) 
Fortran String 1€n oo... ccccscececeseeseeeees len(3F) 
Fortran substring index ........... eee index(3F) 
Fortran SYStOM ooo... ccceccsccecessseeeesseeeeeees system (3F) 
Fortran tangent intrinsic «0.0.0... tan(3F) 
Fortran time accounting mclock ............. mclock(3F) 
Fortran transfer-of-Sign .............ccccecceceee sign(3F) 
Fortran type conversion ftype ................. ftype(3F) 
HP 2640 and 2621-series terminals ...... hp(1) 

ID diskusg diskusg - generate ............... diskusg(1m) 
IED SGIDOND. -wiinrroencereteteremasuecctn cesta setpgrp(2) 
UD sas saasinadaiyscs oaesoeecteeeasa eaten te taioan es getpid(2s) 
ID get real and effective user, ............... getuid(2s) 
ID’s getuid effective user, ....... getuid(2) 
IDS and Names id ............cceeeeecceseeeeeeseeeees id(1) 

IDs getpid get process, ........... getpid(2) 
IDS SOtUIO “sini tasatacianeinnsmciwiciwcas setuid(2) 
IMSP cartridge controller... pt(7) 

IMSP streaming cartridge ........00... ft(7) 

IOT tault-abO cis.dieiednliaialnctcuraws abort(3C) 
Intelligent Communication .........0..0.08. icpdmp(1m) 
Intelligent Communications ................ icp(7) 
L-devices link devices, ......... ees L-devices(4) 
L-dialcodes alphabetic dialing ................ L-dialcodes(4) 
L.cmds remote execution... L.cmds(4) 
L.syS link SYSTEMS oo... eee L.sys(4) 

LP line printer Ip... eeeeereceeeeeeees Ip(1) 

LP printers enable oo... eee eeteees enable(1) 
LP request scheduler and move ............ lpsched(1m) 
LP spooling system Ipadmin .........0........ lpadmin(1m) 
LP status information Ipstat .........000.0.. Ipstat(1) 
Language eff... usa keh aa asehaceales efi(1) 

MM macro package for formatting ......... mm(5) 


MM macros mm print/check ............00.0.. mm(1) 


Microstreamer tape drive 0.0... rm(7) 
OSDD adapter macro package for ........ mosd(5) 
P/75 onboard MOdEM ....... ec eeccccccseeees dial(1) 
PCL network net oo... cccccccsesssteceeesenees net(1) 
PROCESSOR ii sssaiteicctrsctinayauvertinsnaneyeiencungcge IOPUL) 
Racal-Vadic 3451 modem ..............0068 dial(1) 
SCCS Cela Cde: eicsitdnintisesnntsanets cdc(1) 
SCCS deltas COMD ..........ccccceeeeeeceeseeeees comb(1) 
SCCS file delta oo... cceececeseeseetees deita(1) 
SCCS file editing activity sact ....0....0.... sact(1) 
SCCS file Get sicseicise pide; get(1) 
SCCS MNGi OFS sea entireties vermeesogtaans: prs(1) 
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SGCCS Me TMGel i ucraciccieiinnedeeas rmdel(1) 
SGGS file scesdiff. ciscjccuakncdntinss sccsdiff(1) 
SCCS file Sccsfile ......... cc cessteeseeeeeees sccsfile(4) 
SCCS file UNget 0.0... cee cccceeeseeesteeeesees unget(1) 
SCCS TE Wal: ii.ccsssctiiteectcnarniotarens val(1) 
SCCS FES AGM sicker clsvcsed acticnasuenvages admin(1) 
SCCS files what ...........ccccccecseeceeeenees what(1) 
System control and status program ....... sys(1m) 
System control and status ........0008. sys(im) 
System Control ANd ou... eee eeeees sys(1m) 
TEKTRONIX 4014 terminal 4014 ........... 4014(1) 

UID GeIpW ae centectisaiis wana) getpw(3C) 
UNIX system Copy UUCP oe uucp(1) 
UNIX SYStOEM CU oo ceccesteeceeeenaes cu(1) 

UNIX system file system backup ........... filesave(im) 
UNIX system to UNIX system copy ....... uucp(1) 
UNIX system UNaMe ones uname(1) 
UNIX system UNAME ........ cette uname(2) 
UNIX-to-UNIX system command ........... Uuux(1) 
UNIX-to-UNIX system file copy .............. uuto(1) 
USERFILE UUCP pathname ........... USERFILE(4) 
UUCP pathname permissions file .......... USERFILE(4) 
Xerox 9700 printer dx9700 ....... ee. dx9700(1) 
Xerox 9700 printer x9700 oo... ee x9700(1) 

a C program checker lint... lint(1) 


a compiler/interpreter fOr... bs(1) 


a macro package for making ................. mv(7) 

a troff macro package for oe mv(5) 

A, OUL-COMMON scircitecticastncnnsmrmeuss a.out(4) 
a64I convert between long ................ a64|(3C) 
abbreviations file oo... eceeeeceeeeeeeees L-dialcodes(4) 
GDOM fh cssorin sata Aveta setae harasnetaa uss abort(3C) 
BDO .Asisiccodononlatanlinnmees abort(3F) 
BIS cateissedeiathtinurebareuciemtatnceieantecteoian abs(3C) 
ADS soit iarste eiadicattataen Gaeta eae tec abs(3F) 
absolute debugger adb ...... ee adb(1) 
absolute valu€ ADS ...........cccccccceseseeeees abs(3C) 
absolute Value aDS ........ cc eccseeeeeenees abs(3F) 
absolute value functions floor ................ floor(3M) 
access and modification times of ........... touch(1) 
access and modification times ............... utime(2) 
access determine accessibility ............... access(2s) 
access graphical and numerical ............ graphics(1) 
access long integer data in a ................. sputl(3X) 
access profiler sadp ...........c ees sadp(im) 
access routines Idfcn .......... ee Idfcn(4) 
access time COPY 0... eee dcopy(1m) 
access utmp file entry getut ...........0... getut(3C) 


PCCOSS mec taret eet ateshatetn twat ain aeoraetens access(2) 


accessibility of a file access ........0 0.0... access(2) 
accessibility of a file 0... Suet access(2s) 
ACCOUNTING ACCT 0... cee eectceeteeeceesceeeeeees acct(2) 
ACCOUNTING ACCICON 0.0.2... eee eteeeees acctcon(1m) 
accounting commands acct ................. acct(1m) 
accounting data by user ID ......... i. diskusg(1m) 


November 1986 


PERMUTED INDEX 


per-process 
search and print process 

merge or add total 

return Fortran time 

command summary from per-process 
run daily 

or disable process accounting 
miscellaneous accounting commands 
accounting file format 
per-process accounting records 
print process accounting file(s) 
connect-time accounting 

or add total accounting files 
arccosine intrinsic function 
Advanced Commuriication 
Signal signal specify Fortran 

kill all 

system 

system 

system 

print current SCCS file editing 
report process data and system 
formatting mosd the OSDD 
absolute debugger 

acctmerg merge or 

change or 

create and 

part of complex argument 
integer part intrinsic function 

set a process 

change data segment space 
brk change data segment space 
main memory 

fast main memory 

disk rram 

abbreviations file L-dialcodes 
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ea tasetrueeecs acct(4) 
accounting file(s) acctcom ............. acctcom(1) 
accounting files acctmerg ...............ceee acctmerg(1m) 
ACCOUNTING MCIOCK ...... cece seettees mclock(3F) 
accounting records acctcms ............... acctcms(1im) 
ACCOUNTING FUNACCE ooo... eee ee eeeees runacct(1m) 
ACCt CNADIO” isinesunacsensvalwvenntiocesseaibers acct(2) 
acct overview of accounting and _......... acct(1m) 
ACCt PEI-PrOCESS eee eee acct(4) 
acctcms command summary from ........ acctcms(1m) 
acctcom search and oo... eee acctcom(1) 
ACCICON:. -xisssairieinea nec srsepsaoteunucesdueistaheedeanend acctcon(1m) 
ACCIMErG MELGE 2.0... cceeccccccetssteeerseeeseees acctmerg(1m) 
ACOS: FOMAN ssscissivetcaccersisseatindaseuatintsns acos(3F) 
acpdmp dump contents of «0... acpdmp(1m) 
action on receipt of a system ................ signal(3F) 
active processes killall 0.0 killall(1m) 
ACTIVITY GrAPN SAG ou... eeessettteees sag(1) 
activity report package Saf... sar(im) 
activity report Sail 0... eeceeerreeeeeees sail(1) 
ACUVILY SACE  eckcicnes ced eecesaserteudieesansanconands sact(1) 
activity timex time a command, ............. timex(1) 
adapter macro package for 0.0... mosd(5) 
BOO Sick toca checcie yah eoaes ea tarasaeieste adb(1) 
add total accounting files ..................0 acctmerg(1m) 
add value to environment putenv .......... putenv(3C) 
administer SCCS files admin .........00..... admin(1) 
aimag Fortran imaginary ............ccece aimag(3F) 
GIT FOREN sscusetsesconeactsiahorsaensainesnedareaweuss aint(3F) 
Alarm CIOCK Alarm 0... ccc ccesesstseeeteeeees alarm(2) 
AilOCATION DIK siistresactiuleteciceatuiarvene brk(2) 
ANOCATOM: sis ihsvsadesseedasieatatl cawucdusissmcauaners brk(2s) 
allocator MallOC ou... cee eccceseeceeseseeeees malloc(3C) 
allocator MallOC 0.0... cceseeeceeecseeeeeees malloc(3X) 
allows memory to be uSed as a ............ rram(7) 
alphabetic dialing 0.0... een L-dialcodes(4) 
analyze surface characteristics .............. style(1) 
and/or merge files sort ...........000.0.. sort(1) 


Ol ciasenaiiinseresmtamvess oan vnace a smencaciaiomnes ar(4) 


ar archive and library 0... ee ar(1) 
arbitrary-precision arithmetic ............... bce(1) 
arccosine intrinsic function acos ............ acos(3F) 
archive and library maintainer ................ ar(1) 

archive and library maintainer ................ bar(1) 
AICHIVG COO: -sissiccdcv sts che yi fonetazsies sonemmouyaatinnes cpio(4) 
archive file format fF o.........ccceccsceseceeeeenee ar(4) 

archive file Idahread read the ................ ldahread(3X) 


ALCHIVE MOS sc cciiccsccossweetsvarsesasicavieiniansvenes arcv(1) 
archive format arcv archive ............... .. arev(1) 
archive header of a member of an ........ ldahread(3X) 
GICNIVEN Tal jigacsscricceedivs hac iederemeneniens tar(1) 


archives ar archive and... ar(1) 
archives in and out cpio «uu... ee cpio(1) 
arcsine intrinsic functio asin ..............0... asin(3F) 
arctangent intrinsic function ...............0. atan2(3F) 
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arctangert intrinsic function ................. atan(3F) 
arcv convert archive files from .............. arcv(1) 
APQUMENT AIMAG 000.0... eee eeesecteeeeeeeeeenees aimag(3F) 
AFQUMENT GEtAIC 0... ccceeecesceeseseeeees getarc(3F) 
argument list VararGS oo... ee eeeeeeees varargs(5) 
argument list vprintf print .........0.0...8. vprintf(3S) 
argument list(s) and execute .................. xargs(1) 
argument vector getopt .....0... eee getopt(3C) 
arguments as an expression expr ......... expr(1) 
AFQUMENTS ECNO ou... cecceteeeceststeaeeeeeees echo(1) 
arguments for getargv .......... eee getargv(2s) 
arithmetic language DC ow... eee bc(1) 
71d} (a (011 >) (One R o  e eT EI arithmetic(6) 
GSCI Ui.sca icine ea eta ascii(5) 

ASM eactanscsesp ah ade selveiut ue et al oneerteaw asin(3F) 
ask for help help ......... ee eeeeeeees help(1) 
ASK-1Ol NOID: sreisetescavcesd sects yavialed ecdtesceaaoo help(8) 
assembler and link editor output ............ a.out(4) 
ASSEMDIC! AS hisses ateameis as(1) 
ASSEMTION ASSEMT 0... cc ccceseeeeseteeceeeenees assert(3X) 
assign buffering to a stream ........ setbuf(3S) 
ALAN 2: POMC prcsivcnceiiuctanectebes ss votatercesss atan2(3F) 
await completion of process wait ........... wait(1) 

AWK Palo siscndscseernistuadeseuteomentants awk(1) 
DaCkGa@MMON DaCK 0... cceeeee seeeeeees back(6) 
backup filesave daily/weekly ................. filesave(im) 
DACKUD TAC? os 555 cecgreccnttiayerencaeeetnisee ahaa finc(1m) 
backup of a file SysteM oo... ee fobackup(1m) 
backup of a file system 0... ee fbackup(8) 
backup tape frec ......... ietoleaanes frec(1m) 
DaANGr acca ean aleetia banner(1) 
bar Berkeley archive and ............e bar(1) 

base of terminal types by port ..........0..... ttytype(5) 
DaSE TErMINfO ..... ce ceecceteetseneeeneneeens terminfo(4) 
base-64 ASCII string a64) oo... a64l(3C) 
based on ex vi screen-oriented ............. vi(1) 
DASENAME oc eccccsccccccstcccesttseesetseneeneees basename(1) 
be arbitrary-preciSion ..... eee be(1) 

DE sticrsuath ghd eee cvacheedvncheree udetdonntes bdiff(1) 
HeaUtitier CO nenitsismi nesses cb(1) 


become super-user or another user ...... su(1) 


DIS) -iacra dovnsae csc aeiinncecutecnmtace Dace vtasnenetatevens bfs(1) 
DIGGIN DOT rsx evewssacacaedeaiatnsamaabedresipineds bdiff(1) 

big file scanner DfS 0. eceseerteeees bfs(1) 
binary directories cpset .............e ees cpset(1m) 
binary input/output fread 0.0.0... ee fread(3S) 
binary search a sorted table ................. bsearch(3C) 


binary search trees tsearch ................... tsearch(3C) 


bitwise boolean functions bool ............... bool(3F) 
black jack bj ............. ise et neracin et nnages bj(6) 

block count of a file SUM ow... sum(1) 
DIOCK:SVNG 5 sivsticrennbcel mnrednende sync(1) 
DIOCKS Cl sacha sa caucerreeredtrepaaetonmicind df(im) 

DOO footecisinaysarsaabeavemuasdartnebetcensserarteintes bool(3F) 

DEG. \SYVSIOMxiticacincteacs ci ceeacrneeseeues coer: brc(1m) 
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brk change data segment space ........... brk(2s) 

DIK CNANGC? cir) cteascsesicreracecicnmmamnene brk(2) 

bs a compiler/interpreter ......... bs(1) 

DSO AICI iirsessrsiuie donate sicaenrien eee eterno alee bsearch(3C) 
buffered input/output package ................ stdio(3S) 
buffering to a stream setbuf ............... setbuf(3S) 
build special file mknod oe mknod(1m) 
DYt€S SWAD ooo... eccceeccscceeecssteeeereecetnees swab(3C) 
Call sisunasistincagee ils ateakex lt ait Coto daw ecta lees cal(1) 
CAICUIAION CO -aascsiocatccusneeceeareisevenes dc(1) 
CAlONd Al Cab wsavcccisedoivinatavsasterceradiwsaews cal(1) 
CAIGNGSN accciaisteneaweneiesie ies calendar(1) 
call another UNIX system cu ............... cu(1) 
CONPSTAL, susietvaseatevepecestas Seneseerndanisansateeinneons stat(5) 
CONS MM scccctiuicneyeeidersnaecnen aera eeedens link(1m) 
Capability data base terminfo ................ terminfo(4) 
Carriage control characters aSa ............. asa(1) 
cartridge controller... eee ft(7) 
cartridge controller oo... eee pt(7) 
Casual uSers) Edit oc eceeeceeeeeees edit(1) 

cat concatenate and print 0... cat(8) 

CAN seiach cadet asso wiaudeeeae ease eee aan te es cat(1) 

CO). gestuts eit aedhercan os pica tiv ethene anid ceesanwins cb(1) 
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CO! clearence cd(1) 

Cd Change the... ee ceccesseseseneeeeetens cde(1) 
ceiling, remainder, absolute ................. floor(3M) 
CHOW: Si Coctenan tira udl enieme bouts cflow(1) 
change data segment space ................. brk(2) 
change data segment space .................. brk(2s) 
change login password passwd .............. passwd(1) 
Change mode CHM ...... eee eeeeteee chmod(1) 
change mode of file chmod .................... chmod(2) 
change mode Of fil... eee eee .. chmod(2s) © 
change or add value to oo... eee putenv(3C) 
change owner and group of a ............. chown(2) 


change priority of a process ................... mce(2) 


change priority of a process .............4. nice(2s) 
change root directory chroot ................. chroot(2) 
change root directory for a ........ ee chroot(1m) 
change the delta commentary of ........... cdce(1} 
change the format of a text ......... newform(1) 
change working directory cd ............... cd(1) 
change working directory chdir .............. chdir(2) 
change working directory .................6. chdir(2s) 
CHANNEL PIPE 0... eee eeesseeeeeeeeceeeeeees pipe(2) 
character back into input stream ............ ungetc(3S) 
character definitions for eqn and ........... eqnchar(5) 
character login name of the user ........... cuserid(3S) 
character or word from a stream ........... getc(3S) 
character or word on a stream .............. putc(3S) 
Character Set ASCII oo... eeereeeeeeeeee ascii(5) 
CALACIETISICS sce iiesctencvdccetesiebiecseeiereeeees gtty(2s) 
characteristics of a document ................ style(1) 
CNArACTEFISTICS 00.0... eee ceceetcssteeeneneeeeeeees stty(2s) 
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CHALACIEIS Al sa oniudrnneeteraehinainndeouteysocns tr(1) 

chdir change working directory .............. chdir(2s) 
CIGIE nscetusas esaivsradenuctecemeteen nan chdir(2) 
check and interactive repair fsck ........... fsck(1m) 
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chmod change mode Of file ........0.... chmod(2s) 
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ls list 
list 


graphical table of 


interpret ASA carriage 


file 

process 
message 
semaphore 
shared memory 
file 


uucp status inquiry and job 


version 


ft IMSP streaming cartridge 
pt IMSP cartridge 


tty 


translate characters 


terminals term 
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completion of process wait oo... wait(1) 
complex argument aimag ........... ee aimag(3F) 
complex conjugate intrinsic 0.0.0.0... conjg(3F) 
compress and expand files pack ............ pack(1) 
compute the index of a symbol .............. Idtbindex(3X) 
concatenate and print files cat ....00000.0. cat(1) 
concatenate and print files 00, cat(8) 
condition evaluation command .............. test(1) 
CONfiguration FIC oo... ee ete eens ioctl. syscon(4) 
configure logical diSkS .......... ee dconfig(1m) 
configure logical diSKS .........e dconfig(8) 
configure the LP spooling system .......... Ipadmin(1m) 
conjg Fortran Complex .........ce cece conjg(3F) 
conjugate intrinsic function ...........0..0... conjg(3F) 
connect-time accounting acctcon .......... acctcon(1m) 
connection dial establish ................0.00 dial(3C) 
Connection information ...........cccceeeeeees L-devices(4) 
consistency check and interactive ......... fsck(1m) 
consistency check and interactive ......... fsck(8) 
console configuration file 0... ioctl.syscon(4) 
constant-width text for otroff ................... ocw(1) 
CONSTANTS MAN oo... eeeeseeeeeeretettees math(5) 
construct a file system mkfs oi. mkfs(1m) 
construct a file system oe mkfs(8) 
construct argument list(s) and ........00.... xargs(1) 
CONStruCtS Geroff ......... ec eeceeses eens deroff(1) 
contents of directorieS 0.0.0... ls(8) 
contents of directory IS oo... eees Is(1) 
contents routineS tOC ......eeeeeeeee toc(1) 
context split CSplit oe ee erees csplit(1) 
control characters @8@ ............ eects asa(1) 
control device iOCtl ........cecceseescseeeeens ioctl(2) 
CONTO! {CNT whic saeasitane encnaeeae fenti(2) 
control initialization init... eee init(1m) 
control operations MSQGCtl 0... eee msgctl(2) 
control operations Semctl oo... semctl(2) 
control operations SHMCTl occ shmctl(2) 
contro! options fentl oo... eee eeeeees fentl(5) 
COnUOl UUSlal cnc coke anaed ek ties uustat(1) 
CONNOIVGS gsccetvnicraicnunm vienna vce(1) 
CONTONC! siccns wit rntnracaenieaicn ft(7) 
CONMOIGR J ccccicnvectin dheticncenatinccins pt(7) 
controlling terminal interface ........0.0..00. tty(7) 
CONV aie dietrsctnnta we tietcueraaecsnnas Cees conv(3C) 
conventional names foro... term(5) 
CONVETSION fYPE oo... ce cceceescetetteeeteeees ftype(3F) 
conversion program units ............ sabcniiat units(1) 
convert and copy a file dd ow... dd(1) 
convert and copy a file oo dd(8) 
convert archive files from oo... arcv(1) 
convert between 3-byte integers ........... I3tol(3C) 
convert between long integer and ......... a64l(3C) 
convert date and time to string .............. ctime(3C) 
convert floating-point number to ............ ecvt(3C) 
convert formatted input scanf ................. scanf(3S) 
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copy file systems with label ..........00.0... volcopy(1m) 
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copy, link or move fileS Cp... cp(1) 

core image fil€ COPE oo. ec eees core(4) 
COE MEMOSLY MEM .......... cee eeeeeretteeees mem(7) 
cosh Fortran hyperbolic oe cosh(3F) 
cosine intrinsic function cosh ................ cosh(3F) 
cosine intrinsic functions cos .............. cos(3F) 
count Of a fIIE SUM oo... cece cntee ee ees sum(1) 
COURT: WC. cine sce snnaaniinaesree cron wc(1) 
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Creat Create A NEW ou... eee eeesesteteeeees creat(2) 
create a name for a temporary .............. tmpnam(3S) 
create a new file or rewrite an .............. creat(2) 
create a new process fork .............0.00. fork(2) 
Create a new special file... creat(2s) 
create a temporary file tmpfile ............, tmpfile(3S) 
create an interprocess channel .............. pipe(2) 
create and administer SCCS files ......... admin(1) 


creation mask umask ............... eee umask(2) 


Creation MASK... eee eects eeeeeees umask(2s) 
cron - clock daemon Cron. ...........ccccee cron(im) 
CRON TAO icinnsicencsara thse den teatece tonto keds ek crontab(1) 
cross-reference Cxref 0... eeeeeeee: cxref(1) 
cross-reference listing of macro ............. macref(1) 
CIV OL. cease an eaiaratimate eee tees aaaaaonnancantes sacs crypt(1) 
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CSDUL ssssanaciniea.wiinvsnsuriintiierinnttiantaat csplit(1) 
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CIOMNIC Jicsenceehctieacecnneos ctermid(3S) 
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(oD Bear ie eee ree Bey arene nm rete a en NY SRE ETT cu(1) 
current SCCS file editing ..........0 ee. sact(1) 
current UNIX system uname ..........0.0.. uname(1) 
current UNIX system uname ................. uname(2) 
current user ttyslot find ....................... ttyslot(3C) 


current value of a file pointer .........0.00.0. tell(2s) 
current working directory getcwd ........... getcwd(3C) 
curseS CRT SCre@n ou... eeeecererteeeeenee curses(3X) 
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CGAEMON EFFStOP 00... eee eeeeettereeeetees errstop(1m) 
daily accounting runacct ..............0.c runacct(1m) 
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data and system activity timex .....0.00... timex(1) 
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data base of terminal types by ............... ttytype(5) 
data base terminfo ....... eee terminfo(4) 
data by user ID diskusg diskusg ........... diskusg(1m) 
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data segment space allocation .............. brk(2s) 
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ACOPY COPY THO: s...ccsiadstecenseietienesesess dcopy(1m) 
dd convert and copy a file 0... dd(8) 

ONG setae eens Silat ncaa tae omni tans se as dd(1) 
debugger Adb uu... cceeeeeensteeees adb(1) 
debugger Ctrace ia. cen Remake ctrace(1) 
debugger fsdb ou... ceceeectesetrees fsdb(1m) 
GEDUGGEM: satan cicseereeeanieretonee fsdb(8) 
definitions for eqn and neqn. ............... eqnchar(5) 
deliver portions of path names ............... basename(1) 
deliver the last part of a file 0... tail(1) 
delta (change) to an SCCS file .............. delta(1) 
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delta commentary of an SCCS delta ..... cde(1) 
delta from an SCCS file rmdel ............... rmdel(1) 
CGM MAKE series uietusahacnteiteann aia delta(1) 
GEWAS COMI acs daiaiecsatiarcasadehacesduamuaeness comb(1) 
deny messages M@SQ ........ eee mesgq(1) 
deroff remove nroff/troff, 0.00... eee deroff(1) 
description files foro... eee eesteeees font(5) 
description of output language ............... troff(5) 
descriptor ClOS@ oo... eee eeeeeetertateeeens close(2) 
GOSCMPIO‘M CUD wise ces cdesieliredtyshenaarescansentonacs dup(2) 
descriptor is a iSatty oe eens isatty(2s) 
GESCIDION seahiiicidaicia eceimenseinalal close(2s) 
desk calculator dC ee eeees de(1) 
determine accessibility of a file ........0..... access(2) 
determine accessibility of a file .............. access(2s) 
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determine file type file 0... eee file(1) 
GEVICE OCU cisscisiacastissmticewioe teasing ioctl(2) 
CeviCe NAME CEVNM vee eeeteeees devnm(1m) 
device routines and filters gdev ............. gdev(1) 
device-independent troff 0... font(5) 
devices, connection information ............. L-devices(4) 
devnm ....... eer eer eee ee devnm(1m) 
Cece sasedate utes aagtiatis ta aeth Ol naaees naes ose to amano df(1m) 
dformat disk formatter 0.00. dformat(8) 
dial a Racal-Vadic 3451 modenn ............ dial(1) 
dial the P/75 onboard modem ............... dial(1) 
dial establish an out-going «0.0... dial(3C) 
DialeCt TANG! sana isaaciuchin mnie ratfor(1) 
dialing abbreviations file 0, L-dialcodes(4) 
GI INN castaaes se pcertias acon arouses tata bdiff(1) 
eect taceete alee rato nt tant ctcemictclsaneeaeaens diff(1) 
USS? WAY Saco: A coincicadinGrtalandonarecadeians diff3(1) 
difference intrinsic functions .................. dim(3F) 
difference program sdiff 0... sdiff(1) 
differences between files diffmk ............. diffmk(1) 
differential file comparator diff... diff(1) 
differential file comparison 0.0.0... diff3(1) 
OPIN as spesrvnttewstieie hare wit unaihesceaas een meen emenzaeses diffmk(1) 
CIM: DOSIIVE = crus creceretts Hide ie cteaegeretanedoany dim(3F) 
OUD. isrataiete at ohed a aranet ieee ied eet aaton, Bente dir(4) 
CU CIIND 258 extent tesacetenvalegisea teen erat eet ety dircmp(1) 
directories Cpset .....0.. cee eeentees cpset(1m) 
CIFECIONES GIR seiciesesssincdosei acetate aceasueiins dir(4) 
GIFECHOFIES FIM... ececccceteeseeeeseeeeseeesesees FM(1) 
OIGGIONES - cries ted eee Is(8) 
GIECIOIW, CO) siesta sed Geta eoies cd(1) 
Girectory CHAI ......... ccc ceecceessseceeeereetsneees chdir(2) 
CIFECIORY CNLOOL nec timeienioiccomseavaans chroot(2) 
directory clean-up uuclean |... uuclean(1m) 
directory comparison dircmp .............0.. dircmp(1) 
directory entry unlink «0.0... eee unlink(2) 
directory for a command chroot ............. chroot(1m) 
Girectory GetCwd ........cccceccecseecseeeeseseseees getcwd(3C) 
CH OCLONY 1S) ic iccnctvascesosic calnsteetiacaneper bev unaanavane Is(1) 
directory Mkdir ..............cceeee egermiaanedite mkdir(1) 
GIFECHOrY MVGIT occ ceeeteseesstesstsrsenerenees mvdir(1m) 
directory NAME PW ......... ee eeeeeeeceeeeeeees pwd(1) 
directory or a special OF 0... ees mknod(2) 
CIRC CIONY: <ehasanists cpus eocivaaseorpcdsyaawerrameuauaiedes chdir(2s) 
disable process accounting acct ............ acct(2) 
discipline getty set terminal ....0. getty 
disk access profiler sadp ow... sadp(1m) 
disk accounting data by user ID ............ diskusg(1m) 
GiISK: DIOCKS GI cis, cosxcieatticeseecis hdereselante df(1m) 
GISK TOM ANGER ic casiind. Se chtoesicarcsa sin eaaneadceins dformat(8) 
GISK USAGE GU oo... eee eeeeeeeeeeerees sSdesete du(1) 
GISK USAGE y Ae etcdowtenstitne see ieal du(8) 
CIS cicisciicticuatscclaiam anlaaste han rateaacuretvai ramdisk(1m) 
GISK TFAIN tsca vec nsarracd shee emmdicausnhceaiacanenccets rram(7) 
disks ...... dh leseastanata init caishe Aet ton testa octets capaudice dconfig(1m) 
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diskusg - generate disk ...... ee diskusg(im) 
dismount file system mount ...............0005 mount(1m) 
display editor based on eX Vi... vi(1) 

display profile data prof oo... ee prof(1) 
distance function hypot 0.0... eee hypot(3M) 
distributed pseudo-random numbers ..... drand48(3C) 
document compatibility checker ............. mmiint(1) 
document analyZe occ eeeeee style(1) 
documents formatted with the MM ........ mm(1) 
documents mm the ........ cents mm(5) 
documents the OSDD adapter .............. mosd(5) 
documents, viewgraphs, and slides ....... mmt(1) 
doing what WNOO ..........cceeertees whodo(1m) 
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Gouble routin€S ooo... ceeeerceseeeeeee float(2s) 
double-precision number strtod .............. striod(3C) 
dprod double precision .......... eee dprod(3F) 
drand48 generate uniformly ........0000000. drand48(3C) 
draw a graph graph ou... eeeeees graph(1) 
drawing simple pictures... pic(1) 

drill in number facts arithmetic ............... arithmetic(6) 
RVG: sien chops nnaciunaucnuandomeaan rm(7) 

du summarize disk usage ........... a. du(8) 

(2 [1 eee ret een a eee eee eR ane eee du(1) 

dump contents of Advanced ..........0.... acpdmp(1m) 
dump contents of ano... ee icpdmp(1m) 
dump errdead ou... eeceeeeeeeeeenreen errdead(1m) 
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dump selected parts of an... dump(1) 
dump tape format 0... eee reteee dump(4) 
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dx9700 prepare troff documents ............ dx9700(1) 
echo arguments €Cho ......... eee echo(1) 
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Edit text CditOr 0. ee ceeeeeeeeeen edit(1) 
editing activity SACt 0... eens sact(1) 
editor (variant of ex for casual ............... edit(1) 
editor based ON EX Vi oe eeeeees vi(1) 
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editor for common object files Id ............ Id(1) 
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Cl sce sanine a gauct aieeotaslanais Sewtani vane acaeanins tanec efl(1) 
enable or disable process |... acct(2) 

CN ADS si iiicciesi Wiecadiuinmertndesetan enable(1) 
enable/disable LP printers ....00000... enable(1) 
encode/decode a binary file .........00...... uuencode(1c) 
Encode/decode Crypto... crypt(1) 
ENCTYPTION CIYPt oe eececeeeeteeeteeteeenes Crypt(3C) 
encryption key makekey ..............0cce makekey(1) 
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environment name getenv ..............4. 
ENVIrONMENt PUTENV 00.0... cece 
environment variable getenv .............. 
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eqn format mathematical text ............. 
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ex for casual users) edit ............... 
ex vi screen-oriented 00.0... ees 
examine system images crash .......... 
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EXECUTION COMMANMS ......... cette L.cmds(4) 
EXECUTION CNV ooo... cccsccecccccesseeeceesenseeeees env(1)} 
execution for interval sleep ...............00. sleep(3C) 
execution profile Monitor ........0... ee monitor(3C) 
execution time profile profil ............0.0.. profil(2) 
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expand fileS paCk 0.0... ee eee pack(1) 
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EXPFESSION EXPE ec cceseeeeceeesereeeeeees expr(1) 
EXPFESSION FEGCMD ........ccceececcceesereteeeeees regcmp(3X) 
extract error records from dump ............ errdead(1m) 
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f77, ratfor, or efl files fsplit 0. fsplit(1) 
facilities status ipcs report 0.0.0.0... ipcs(1) 
factor a number factor ............... eee factor(1) 
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NIGPACCOSS > cacsascraavasecncsutnsanioe amencaeeys access(2) 
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file Control fONtl .o...cccccccce cece fontl(2) 
file control options fentl ........ ee fentl(5) 
THE CODY UNIO 5, aedicesv chao tecaticestarealaucasen! uuto(1) 
WO CONG! passin asacc tal anid core(4) 
file creation mask uMaSK ....... ee umask(2) 
fIIE CrEATION MASK eusiscriceisscessioveercveyortovens umask(2s) 
NG CrOntab ea Gade ee crontab(1) 
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TNCZOO) 6.ceig2 cree ncetecemmapacveence evened dd(1) 
MEO GM a 2 o8 toh vs SesdernctacerorccuneabennnatoasnSs delta(1) 
file descriptor CIOSE ooo. eeeeeeee close(2) 
file descriptor CUP .......... ec eeceeeseceeeetees dup(2) 
file descriptor is a isatty ....... ee isatty(2s) 
file: G@SCNplON .2isesacah isan close(2s) 
MMO’ QUIN D> scl air cow etaicaareoumoamnseeane dump(1) 
file editing activity Sact ......... ee sact(1) 
file entry Getgrent ..........eccccceeeseeeteeees getgrent(3C) 
file entry GEtPWENT oo... eee ceetees getpwent(3C) 
TG CNY GOLUt citi Saccrintivcsvatourecarcienecans getut(3C) 
file Entry PULPWENT occ cceeeees putpwent(3C) 
TIIB“OXOC Sas schavaeavegeresssa tien eanariaons exec(2) 
file for a pattern Qrep oo... creer grep(1) 
file for reading Idopen ........ ee Idopen(3X) 
file forMat ACCH 0.0... ceeeeeeecceseeeeteaseeeeess acct(4) 
HE TOMA Al aoicse oP Borearandsigeeds ar(4) 
file format @rrfile 0.0.0... eecceseenaeeeeeees errfile(4) 
file function Idlread line oo... ee Idlread(3X) 
TUG 'GOL -siorarid eeercrtinncescengeasiedeletumtmrceveree. get(1) 
THO QUOUD seatocssecncwentenccte cena aut bvceanacvenn group(4) 
file header for common object ............... filendr(4) 
file header of a common object ............. Idfhread(3X) 
file header of a common object ............. Idohseek(3X) 
file into pieces Split 0... ee estes split(1) 
VIG: ISSUC 525 sia scastesechtaered Gtanctaes ict cscencniaals issue(4) 
file Idahread read the archive ................ Idahread(3Xx) 
TIS IGCIOSG saciecncctislspcneriien unas Idclose(3X) 
file Idfhread read the oo... eee Idfhread(3X) 
file Ildlseek line number entries .............. Idiseek(3X) 
file Idonseek to the optional ........0..0.. Idohseek(3X) 
file idrseek relocation entries ................. ldrseek(3X) 
file Idshread an indexed/named ............ Idshread(3X) 
file ldsseek an indexed/namegd .............. Idsseek(3X) 
file Idtbindex index of a symbol ............. Idtbindex(3X) 
file \dtbread an indexed symbol ............ Idtbread(3X) 
file Idtbseek seek to the ............ ee Idtbseek(3X) 
file lNENUM LINE ooo cece eeeeeeees linenum(4) 
THEW wcccestenit atncenataeen sais caved cutaminwen tented link(2) 
TG INKNOG: accascireancchiedesnusticn staat uumlcateteaeouors mknod(1m) 
file mknod make a directory ............0..... mknod(2) 
file name for terminal ctermid .........0...... ctermid(3S) 
file MAME MKTEMP o.oo. eee eee mktemp(3C) 
file names and statistics fora... ff(1m) 
FIG MEWHOFIN 0... cccccesteccecenetseereeneaas newform(1) 
TSO, Losiisteciinict teen tecanngnene ese tices bats nm(1) 
1 LP=3 91 6 || Baran Sener ere eotceerte natin ones corre enn yn null(7) 
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find the slot in the utmp 

identify processes using a 

creat create a new 

password 

files or subsequent lines of one 
terminals pg 

reposition a 

move read/write 

lseek move read/write 

report the current value of a 

print an SCCS 

read from 

information for a common object 
remove a delta from an SCCS 
big 

compare two versions of an SCCS 
format of SCCS 

header for a common object 

get 

stat get 

information from a common object 
processes using a file or 
checksum and block count of a 
symbol name for common object 
common object 

daily/weekly UNIX system 
checkall faster 

interactive repair fsck 

and interactive repair fsck 


fsdb 

file names and statistics for a 
construct a 

mount and dismount 

mount a 

incremental 

restor incremental 

get 

ustat get 

mounted 

unmount a 

mount a 

unmount a 

make a fast tape backup of a 
time dcopy copy 

checkiist list of 

valcopy copy 

deliver the last part of a 
create a temporary 

create a name for a temporary 
and modification times of a 
uucp system uuUCcico 

walk a 

determine 

undo a previous get of an SCCS 
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file of the current user ttyslot ................. ttyslot(3C) 
file or file structure fuser oo... eee fuser(1m) 
file or rewrite an existing one ..............6. creat(2) 

TG DASSWO cs ceaakes cesar sad astivesuasWietamubeadise passwd(4) 
file paste same lines of several ............. paste(1) 

file perusal filter for soft-copy ............0.4. pgq(1) 

file pointer in a stream fseek ................. fseek(3S) 
file pointer ISC@K oo... eect eeestaees lseek(2) 

THE POWER oxessuciesseiasestayertis rn dentuliracinanness lseek(2s) 
TIS DOIN R TOW esd asncsSeonspendesteln aieueaitiosen tell(2s) 

TG SOUS erent alate onaarvormeiacn sans eee katte prs(1) 

NG TOA heat el caraatercnunouieti a @rcniies read(2) 

file reloc relocation 0... cc cceeeeees reloc(4) 

TNO TINGE! co Spleen eke oaeadian rmdel(1) 

file SCANNEL DFS oo... cece cee ceeesessseeeeees bfs(1) 

THES COSO UD stiles bites enextntnisga tes Redes Oathezias sccsdiff(1) 
TE SCCSMNE  sssiecsvcas soseselonnandensdinee deers sccsfile(4) 
file Scnhdr SECTION ............ cc ccccceseeeeereeeeeees scnhdr(4) 
fil@StatUS Slat -ccsisiiacnssoricntentinanteatioss Stat(2) 

j= ER 118 [on stat(2s) 

file strip and line number .................008 strip(1) 

file structure fuser identify ..........e. fuser(1m) 
HG SUI DMN a auecasistteseeeedawatwearieees sum(1) 

file symbol table entry Idgetname .......... Idgetname(3X) 
file symbol table format syms ............00. syms(4) 

file system backup filesave 0.0.00... filesave(1m) 
file system checking procedure .............. checkall(1m) 
file system consistency check anc ........ fsck(1m) 

file system consistency check ............... fsck(8) 

file system debugger fsdb .......... fsdb(1m) 
file system GebUGGEr oo... ees fsdb(8) 

file system ff list oo... eeecetsteeeeeeeee ff(1m) 

file System MKFS oo. cceeereeeeees mkfs(1m) 
fil€ SYSTEM MOUNT ...... cece etree mount(1m) 
file SyStEM MOUNT ou... ce cceeteees mount(2) 
file system restore oo... eee restor(im) 
fil€ SYSTEM TESTOE ............cccccceecesserseeeeeees restor(8) 

file system statistics ustat oo . ustat(2) 

file system statistics 0.00.00. ustat(2s) 
file system table mnttab 00... mnttab(4) 
file SYSTEM UMOUNT ....... cc cceseceeeeees umount(2) 
THO SVSIOMN \ccccasiereansusatiedorinreesteaceigvoastpuaianas mount(2s) 
TIGSSYSIOM : c5sdir i iatuanes coaessieced tee neaa patna umount(2s) 
file system fOACKUP oe eee fbackup(1m) 
file systems for optimal access. .............. dcopy(im) 
file systems processed by fsck .............. checklist(4) 
file systems with label checking ............. volcopy(1m) 


TGA: oa edetecsdai acre tices: iis) Bac meuondes tail(1) 


TUCO AMV OMIG sscesssscoteecsten dd sncaeactetinemiscteoes tmpfile(3S) 

THE WBA eos cias ter Secdentear ous Bamvnneses tmpnam(3S) 

file touch update access ..............cee touch(1) 

file transport program for oo... uucico 

TS TOO IW tint eacs Re chreatoc ac rateneni ceceiccardos ftw(3C) 

ANG TYPO TO i ian cis abies iieeetuacsatareeaveveles file(1) 

THE UNGOR eit er chee ee ncaa hg den eaconennas unget(1) 
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report repeated lines in a 
validate SCCS 

write on a 

creat create a new special 
determine file type 

mknod make a special 

read read from 

write on a 

and print process accounting 
set 

format of compiled term 
header for common object files 
merge or add total accounting 
create and administer SCCS 
concatenate and print 
compare two 

reject lines common to two sorted 
copy, link or move 

_ mark differences between 
file header for common object 
recover 

format specification in text 

split f77, ratfor, or ef 

string, format of graphical 
install object 

link editor for common object 
remove 

merge same lines of several 
compress and expand 

print 

section sizes of common object 
sort and/or merge 

identify SCCS 

archive format convert archive 
UNIX system file system backup 
file perusal 

select terminal 

line numbering 


graphical device routines and 
graphics 
fast incremental backup 


object library lorder 


the current user ttyslot 
find files 


ecvt convert 

manipulate parts of 

absolute value functions floor 
generate C 

close or 

open a stream 
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THA se sress na tics cacssestlscasecetehees seine uniq(1) % 
THE Nal recicoo cestbeytedewetnatena torte val(1) . ] 
TNS WHS s.ctsartsctdaonneatsbolttcdeaminiucrsauiatous write(2) Tisai 
TNO cactiscca ioe as ieaeu seaman sme ema tomes creat(2s) 
TUS sce cere ches sen ae ears taee cuinsin etaaecatecat file(1) 
NN cui cases acura ance en a aseen Gunaeeteeed mknod(2s) 
VIG icdicterast agate ae itecues temic dtm bicamaaeeh read(2s) 
TG ages tesaa tient Aasnetncateat taitaunet eomceere nae dline write(2s) 
file(S) acctCOM SEarCN ......... eee cece acctcom(1) 
file-creation mode mask umask .............. umask(1) 
THOS, UOTE eitresd sears ache reat reorarrtas tans nenes term(4) 
THONGE THC ae jsaiiccen osu anneisevetetientes filendr(4) 
FIGS ACCUM OF tssv seis cdherdccwsshytiavetsavennboateive acctmerg(1m) 
THOS AG acre esses cesuceessauvaicieadebeotadesteret admin(1) 
WIOS COU wicteteciest tide waeiemet wanes cat(1) 
THES COND inci asarteeasies raeccue ceeemncanateted cmp(1) 
filles COMM SElECT OF ou... cece eeeeees comm(1) 
TOS CO ss cssscrsteriasecisest aims tasenerneciomeiainre cp(1) 
THOS PIN soe catsvess sqiesdnatentsdadetratneiaceesauters diffmk(1) 
THOS THONG vaitoicteteaiia election Raea clas: filendr(4) 
files from a backup tape frec .............. frec(1m) 
TES TSOOC sissies vaca cucistanctivveseramins cnduae: fspec(4) 
NUSS TSO i pteeta ete ceases ceetes tan natnemclawess fsplit(1) 
files gps graphical primitive 000... gps(4) 
files in binary directories cpset .....0......... cpset(1m) 
HSS AG. castiivsvenssiotdostuesauacanitnientasomstainre Id(1) 
files or directorieS rM oo... eee rm(1) S; 
files or subsequent lines of one ............. paste(1) J) 
WES: DACK stivicctycuveaatehiiet icine: pack(1) 
THOS OU saat ceceidacdaestunstedeetdamecrradamietcs pr(1) 
TileS:SIZ@" OHNE soto Guietstteeinnncdely adds size(1) 
THES “SOM: chic sh aaanaceitauseieatentiesaamentehe! sort(1) 
TNS WIV AY sdcsccrs olsSrssssdecientecptnetsivsutionncnes what(1) 
VUNG ersevckccedi teed ouesctedevsa sat teedanty ebdues eae dacots arcv(1) 
filesave daily/weekly 0.0... ees filesave(1m) 
filter for soft-copy terminals pg ............... pgq(1) 
TINGP QIECK wise: iar vociscuegnatvistenersbnsieies greek(1) 
THESE AS cavnssact sant cyatnc ctv ctasteveceaveeiatiavtaundaions ni(1) 
filter reverse line-feeds Colo... col({1) 
TIMGTS GGOV ex seciti coucisnnaielesSagndeeutieaseaieunnaevecs gdev(1) 
TORS 1DIOE So sccesahiiant ceeding unt: tplot(1) 
Lig CREO nER no tee ee et eran meer eon Serra een ye» finc(1m) 
find hyphenated words hyphen .............. hyphen(1) 
find name of a terminal ttyname ............ ttyname(3C) 
find ordering relation for an ..........0..0..... lorder(1) 
find spelling errors spell... spell(1) 
find the slot in the utmp file of ............... ttyslot(3C) 
TING coca tert scene seed eatuies ucucseu te vous acta tnin Goabas find(1) 
float and double routines |... float(2s) 
floating-point number to string ................ ecvt(3C) 
floating-point numbers frexp ...........00.. frexp(3S) 
floor, ceiling, remainder, ................66 floor(3M) 
flow graph CHOW ........ eee eecceeecrereeettees cflow(1) | 
flush a stream fcloSe uu... fclose(3S) 2 J 
TODOND czscsises eceecccseeisennstraettataardraiaeontcass fopen(3S) 
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-_ Create A MEW ProCeSS fFOFK cece eescsesesestesseeteeseseeseseees fork(2) 
bg per-process accounting file format ACCt 0... eceeeteteeeectteeeeens acct(4) 
a common archive file format af oo... cocci ceecsece tester ar(4) 
common archive format arcv archive files .............00...0... arcv(1) 
error-log file format errfile 00... cccceesssteeceeeeeeees errfile(4) 
nroff or troff eqn format mathematical text for ........0....... eqn(1) 
format of SCCS file sccsfile ........0.... sccsfile(4) 
change the format of a text file newform 1.0.0... newform(1) 
format of an i-node inode ...............0... inode(4) 
term format of compiled term file. 0.0.00. term(4) 
format of core image file core ................ core(4) 
format of cpio archive cpio ...........0...08. cpio(4) 
| format of directories dir ............ ee dir(4) 
graphical primitive string, format of graphical files gps... gps(4) 
format of system volume fs .........0...... fs(4) 
nroff format or typeset text ............ eee nroff(1) 
files fspec format specification in text 0... fspec(4) 
common object file symbol table format SYMS ..............cccccccssssecsseeeseeseeeereens syms(4) 
to! format tables for nroff or troff’ ...........0... tbl(1) 
Sroff format text ........ cc ceecesesenscnseesens sroff(1) 
utmp and wtmp entry formats UtMP 0.0... eccteeeeeeteeteteeeeees utmp(4) 
convert formatted input scanf oe scanf(3S) 
argument list vprintf print formatted output of a varargs ............0.... vprintf(3S) 
print formatted output printf .......0..... eee printf(3S) 
dformat disk formatter .......... cc cessesessceceeceeseesseeeeeens dformat(8) 
a _ mptx the macro package for formatting a permuted index ..........0....... mptx(5) 
. troff text formatting and typesetting .............0.04. troff(1) 
_. mm the MM macro package for formatting documents ........... eee mm/(5) 
OSDD adapter macro package for formatting documents mosd the ............ mosd(5) 
man macros for formatting entries in this manual ............ man(5) 
binary input/output fread oo. ececccecseneceteteeecteeenseesereees fread(3S) 
recover files from a DaCkUp tape fFEC ie cceeceneeeeseneeetaeeeneeteneceneeeees frec(1m) 
report number of free disk DIOCKS df oo... cece cette eeees df(1m) 
parts of floating-point numbers frexp manipulate 0.0.0.0... eee eeeeee frexp(3S) 
format Of SysteM VOIUME FS oo... ec ccecctssttettettetsseteseeeessesseseseees fs(4) 
list of file systems processed by fsck CheCKIiSt oo... ec ccceeeeseereeeenteees checklist(4) 
check and interactive repair fsck file system consistency ................... fsck(8) 
check and interactive repair fsck file system consistency ................. fsck(1m) 
fsdb file system debugger ...............0. fsdb(8) 
file system debugger fSdD ou... eee cccessssssseeececssenseseesatesenses fsdb(im) 
a file pointer in a stream fseek reposition 0.00... eects fseek(3S) 
specification in text files fspec format ......0.. eset cseeeaees fspec(4) 
split f77, ratfor, or efl filles fsplit oe eeeeeteeeenreeneeeens fsplit(1) 
controller ft IMSP streaming cartridge ..............0.. ft(7) 
Walk: a: fil 1G" TW sisaceciatsceeenversariereetcstitoieransuedidudicveplaviaten ftw(3C) 
explicit Fortran type ConverSion  ffYPe oo... ee ceneeceeceteeeeeeeenaereeennees ftype(3F) 
Fortran arcsine intrinsic fUNctio ASIN oo. eeeeeeeertteeeeens asin(3F) 
Fortran arccosine intrinsic fUNCTION ACOS oo... ccc eceeeceeeeenteees acos(3F) 
Fortran integer part intrinsic function aint .....0.0..... ccc ceceeeteeeeeees aint(3F) 
function erf error function and complementary error ......... erf(3M) 
Fortran arctangert intrinsic fUNCtion atan oo. ceceeeseeteeeeenaees atan(3F) 
eos, Fortran arctangent intrinsic function atan2 oo... cece eee eeeeteees atan2(3F) 
( | complex conjugate intrinsic function conjg Fortran ou... eee conjg(3F) 
hyperbolic cosine intrinsic function cosh Fortran... cosh(3F) 
precision product intrinsic function dprod double |... dprod(3F) 
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function and complementary error 
Fortran exponential intrinsic 
logarithm, power, square root 
log gamma 

Euclidean distance 

entries of a common object file 
natural logarithm intrinsic 
common logarithm intrinsic 
error-handling 

profile within a 
transfer-of-sign intrinsic 
Fortran sine intrinsic 

Fortran hyperbolic sine intrinsic 
Fortran square root intrinsic 
Fortran tangent intrinsic 
hyperbolic tangent intrinsic 
math 

Fortran bitwise boolean 
Fortran cosine intrinsic 
positive difference intrinsic 
remainder, absolute value 
Fortran maximum-value 
Fortran minimum-value 
Fortran remaindering intrinsic 
terminals 300 handle special 
2621-series handle special 
terminal 450 handle special 
Fortran nearest integer 
hyperbolic 

string comparision intrinsic 
trigonometric 

using a file or file structure 
guessing 

the 

the 

the 

the 

log gamma function 

device routines and filters 
graphic editor 

tty 


cross-reference cxref 


user ID diskusg diskusg 


ctermid 

ncheck 

lexical tasks lex 

pseudo-random numbers drand48 
simple random-number 

random number 
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function erf error erf(3M) 
function exp exp(3F) 
function exp exponential, ...........00., exp(3M) 


CCC c ee asec arecesasesesteeecrenesessre 


FUNCTION GAMMA! ...... ee ceccceeteeertteeeees gamma(3M) 
FUNCTION NYPOt oo... eee cecceeeeeteetereeeeteees hypot(3M) 
function Idiread line number ................. Idiread(3X) 
function log Fortran .0........cceeseeeees log(3F) 
function log10 Fortran oo... ee log10(3F) 
FUNCTION Mather 0... ceeeeete eee eeeees matherr(3M) 
TUNICUION: DION cakes ccsvnern ci erdaenasiasveereyaeueene prof(5) 
function Sign Fortran... eeeeeeee sign(3F) 
TUNCUON SIN: Secuencia wes sin(3F) 
TUITION SS ITN anctjnesapurssrcvinsanienecevsscsnsertans sinh(SF) 
TUNCHON SOM teeter cutntnendemeasss sqrt(3F) 
TUNCTON CAN: sovacccescaioncic avedatannersiesionsaaiens tan(3F) 
function tanh Fortran. .............ccceseeeeeeee tanh(3F) 
functions and constants math ............... math(5) 
TUNCTIORNS DOG) ie acne iemieieas bool(3F) 
THNCTIONS COS. ntiietucnrcrs sneer cos(3F) 
TUNCHONS CIM: std ai nbecmrencmshadiates dim(3F) 
functions floor floor, ceiling, ..............0 floor(3M) 
FUNCTIONS MAX ......ccccceccesscccsesseesereseteeeens max(3F) 
FUNCTIONS MIN... ccccceseteeccetteeaerteeeeeees min(3F) 
FUNCTIONS MOT ....... cc cececeeteceteceteeereeteeeees mod(3F) 
functions of DASI 300 and 300s ............ 300(1) 
functions of HP 2640 and ...... a. hp(1) 
functions of the DASI 450 ou... 450(1) 
FUNCTIONS FOUN 00.00... ceeeceesseeesteeeteteeees round(3F) 
FUNCTIONS SHINN ....... eee ecetteeceetseeeeeseeeeees sinh(3M) 
FUNCTIONS STFCMP oe ee eecsceettecteeeeenes strcmp(3F) 
FUNCTIONS THQ ..... elect cesetteteeteetaeeees trig(3M) 
fuser identify proceSsSesS ............c eee fuser(1m) 
GAINS MOO: 9.54 ieetercreasenuetoaceratidtees moo(6) 
game of backgammon back .................. back(6) 
game of black jack bj bj(6) 

Game Of CrAPS CFAPS oo... eee craps(6) 
game of hunt-the-wumpus wun ........... wump(6) 
GaN a 4.24 okies tae ieaen, gamma(3M) 
gdev graphical oo... eeeeeeeeeeereee gdev(1) 
GEO: Scvicicsaessnee wou tenslveidvarimavenncendtvatace ged(1) 
general terminal interface ........0..... tty(7) 
generate C flow graph cflow ...........8. cflow(1) 
generate C program oe eeeeereeeee cxref(1) 
generate DES encryption crypt .............. crypt(3C) 
generate A MAZE MAZE ........eeeceecceseneees maze(6) 
generate an IOT fault abort 0... abort(3C) 
generate disk accounting data by ......... diskusg(im) 
generate encryption key makekey ......... ‘makekey(1) 
generate file name for terminal .............. ctermid(3S) 
generate names from i-numbers ........... ncheck(1m) 
generate programs for simple ................ lex(1) 
generate uniformly distributed ................ drand48(3C) 
GENELATOL FAN oo. ec cc ceeteeeetetteeetnenens rand(3C) 
Generator FAN’ oo. eeeeteeectteeeens rand(3F) 
get a string from a stream gets .............. gets(3S) 


- 20- Plexus Sys 5.21 UNIX 


get 


user cuserid 
stream getc 
nlist 


stat 
ustat 
ustat 


uname 

vector getopt 

getpwent 

working directory getcwd 
getpid 

times 

parent process IDs getpid 

and real and effective getuid 
real group, and effective group 


( time 
Fortran command-line argument 
and get arguments for 

character or word from a stream 
of current working directory 

return value for environment name 
Fortran environment variable 

get group file entry 

get login name 

parse command options 

letter from argument vector 

read a password 


group, and parent process IDs 
get name from VID 

get password file entry 

get a string from a stream 

and terminal settings used by 
spawn 

terminal settings used by getty 
user, and real and effective 
group, and effective group ID's 
access utmp file entry 

string, format of graphical files 
generate C flow 

draw a 

system activity 
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get a version of a SCCS file oe. get(1) 

get and set user limits ulimit .............000.. ulimit(2) 
get character login name of the ............. cuserid(3S) 
get character or word from a .............8. getc(3S) 


get entries from name list ................06. nlist(3C) 


get file status Stat oes stat(2) 

Get file StatUS oo ececeeteceeereeeetaaes stat(2s) 

get file system statisticS 0.0. ustat(2) 

get file system statistics ...00.. 0. ustat(2s) 
get group file entry getgrent 0.0.0.0... getgrent(3C) 
get login name getlogin .......... ee getlogin(3C) 
get login name logname ............... eee logname(1) 
get message queue msqgqget .................. msgget(2) 
get name from UID getpw ..................6. getpw(3C) 
get name of current UNIX system ......... uname(2) 
get option letter from argument .............. getopt(3C) 
get password file entry «0.0.00... eee getpwent(3C) 
get path-name of current ............ ee getcwd(3C) 
Get process ID occas Meialinntoes getpid(2s) 
get process and child process. ............... times(2) 

get process, process group, and ............ getpid(2) 


get real and effective user, ................. getuid(2s) 


get real user, effective user, ................6. getuid(2) 
get set of semaphores semcet .............. semget(2) 
get shared memory segment ................ shmget(2) 


get terminal characterisitcs ..0.0.. gtty(2s) 


get the name of the terminal .........0..0.... tty(1) 
COU TUNIS TMC i caverresciscniscacoseecempandnisanvutente time(2) 
GGUAIMG. 223 en eich eesti time(2s) 
Getare FSTUM: avietee daieeaeeacicaiAviauiere getarc(3F) 
getargv display a program name ............ getargv(2s) 
QEIC OE? inteodanchtseisateanlimceiosHohiaite getc(3S) 
getcwd get path-name ou... cece getcwd(3C) 
GEICDV scat eis ar eedes aeons getenv(3C) 
QEIENV FEMI. 5. cseicncicieriscscnssiatessetasaburavees getenv(3F) 
COTO css sescctest eactsaiiainRatantintnn lon Sienearens getgrent(3C) 
GENOGIN qihenccrodtscitivenmapisucrdszivnetarey: deebentened getlogin(3C) 
getopt ........ eee err eerie getopt(1) 
Getopt get OPtioN oo... eccceseeeseeeees getopt(3C) 
GE aSS ainda rus amen getpass(3C) 
getpid get process ID owen getpid(2s) 
getpid get process, proceSS ou getpid(2) 
OLOW  sieegstcierrtsteeea ervey atvecdeohanMeeaetentess getpw(3C) 
GOIDWONE: sistas wnancuisiehtencs getpwent(3C) 
G68 stars diunnnenaadnteanasin gets(3S) 
getty gettydefs Speed neces gettydefs(4) 
getty to a remote terminal ct ..........0. ct(1) 
gettydefs speed and on. eeeen gettydefs(4) 
getuid get real and effective ......... getuid(2s) 
getuid effective user, real... getuid(2) 
COU aisisrniecatcdasriaentatatsa tutes etieninteosieacues getut(3C) 
QPS graphical primMitiVe once gps(4) 
Graph CHOW niciscsisaxcaecescnrassrviernpantacaeoann cflow(1) 
QUADIN OFAN -sscccanectsscsstey irate i tededaavaneets graph(1) 
GlADIY SAG sicssticssavectacadeniesvenatoneccmensts sag(1) 
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draw a graph 


graphics access 

statistical network useful with 
filters gdev 

primitive string, format of 
routines toc 


. plot 
graphical and numerical commands 
a macro package for making view 
select terminal filter 

search a file for a pattern 

set process 

user, and real and effective 

user, real group, and effective 
print user and 

set user and 
change owner or 
, get 


log in to a new 

change owner and 

send a signal to a process ora 
group file 

real user, effective user, real 
getpid get process, process 
maintain, update, and regenerate 
characterisitcs 


graphical utilities 

300 and 300s terminals 300 
2640 and 2621-series terminals 
DASI 450 terminal 450 

varargs 

curses CRT screen 

guess the word 

run a command immune to 
manage 

scnhdr section 

filendr file 

ldfhread read the file 

seek to the optional file 

read an indexed/named section 
file ldahread read the archive 


. ask for help 
HP 2640 and 2621-series terminals 
manage hash search tables 

the game of 

function cosh Fortran 
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QUAD: ice AV eateries ae ntenseectnee graph(1) \ 
graphic editor ged ou... ee eeesssstreees ged(1) y 
graphical and numerical commands ...... graphics(1) 
graphical commands Stat ....... stat(1) 
graphical device routines and ................ gdev(1) 
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member of an archive file 0.0... Idahread(3X) 
memory allocator malloc ...............c00 malloc(3C) 
memory allocator malloc ............ malloc(3X) 
MEMOTSY AS ISK ............ccccceecceceeeeestteeeeees ramdisk(1m) 
memory contro! operations shmctl ......... shmctl(2) 
memory id ipcrm remove a message ... ipcrm(1) 
MGEMON) MEM siccscind Maier iasaets mem(7) 
memory operations memory ...............05 memory(3C) 
memory operations shmop... shmop(2) 
MOMOlY PIOCK. 0. itersseieate soem sirius plock(2) 
memory segment shmc¢et ................0 shmget(2) 
memory to be used as a disk ................ rram(7) 
TN GMIONY. shssssesavigsdujectsdxeessvtunatiais actsbaeoaens memory(3C) 
- 27 - November 1986 


PERMUTED INDEX 


_ sort and/or 

files acctmerg 

or subsequent lines of one 
permit or deny messages 
msgctl 


interactive 

get 

shared memory id remove a 
permit or deny 

system error 

Fortran minimum-value functions 
two identical 

overview of accounting and 
make a directory 


construct a file system 


build special file 

or a special or ordinary file 
make a unique file name 
formatted with the MM macros 
formatting documents 
document compatibility checker 
viewgraphs, and slides 
mounted file system table 
remaindering intrinsic functions 
change 

set file-creation 

chmod change 

dial a Racal-Vadic 3451 

mdial dial the P/75 onboard 

a compiler/interpreter for 

touch update access and 

set file access and 


prepare execution profile 
guessing game 

package for formatting documents 
mount 

mount 

| establish 
mount and dismount file system 
mount a file system 

mnttab 


copy, link or 

Ilseek 

lseek 

the LP request scheduler and 
formatting a permuted index 
message control operations 
get message queue 

message operations 

view graphs 


November 1986 


merge files sort 
merge or add total accounting 
merge same lines of several files 


Seo Peeters deers ee race snsseanesetonetesaes 


eee eee eee ee eee eee eee eee eee eee eee eee eee eee ee) 


mesg 
message control operations 
message operations msgop 
message processing system mailx 
message queue msgget 
message queue, semaphore set or 
messages mesg 
messages perror 
min 
mirutil utility for connecting 


Cee wesesesreseonesereeeereseere 


Ce moe wero versateweresnrsssere 


POR ease emer es er eer esses EaeeHEeFeeeseseeedeseoeeneers 


seeseneeaece 


seeeeere 


eosscves 


evcecnve 


eoeaeoee 


sort(1) 
acctmerg(1m) 
paste(1) 
mesg(1) 
msgctl(2) 
msgop(2) 
mailx(1) 
msgget(2) 
ipcrm(1) 
mesgq(1) 
perror(3C) 
min(3F) 
mirutil(1m) 


miscellaneous accounting commands ... acct(1m) 


mkdir 


mkfs 


Bea ee oes eresaerear essere css este eeeteeeeereerresenuee 


mknod 
mknod make a directory 
mktemp 
mm print/check documents 
mm the MM macro package for 
mmilint sroff/MM nroff/MM 
mmt typeset documents, 

mnttab 
mod Fortran 
mode chmod 
mode mask umask 
mode of file 
modem 
modem 
modest-sized programs bs 
modification times of a file 
modification times utime 
monitor uucp network uusub 
monitor 
moo 
mosd the OSDD adapter macro 
mount a file system 
mount and dismount file system 
mount table setmnt 


CORRS eae EHH rE HET EH HEHEHE EE HEEE EH OO EEOC ERO EDE 
COceereessaneere 
eee eee eee eee eee ee eee eee eee eee ee ey 
tee cecearere 
oeore 

Peers eseeavese 
Pe eeeneeecrccases 
COUR e dee ces erenessenvesrestareeseneseateseeers 
Sete homecare nesesssassereraseseseasse 

Stee Ree oorsesesestsaseseanacseersesre 
CBee eer nceceseserecserie@ 
Pee er acest es raeetseesecserenausesecsrs 
PRAHA EERE HH RHHR TEE EEE H EHH E EDAD ED eRESESeIE 
SOP RO eS HSE LER ETO MEH HCH e HT eR HH EEH EH EeEeEsarE 

Pevessasecarcs 
eeeeeteneneveres 
Ceeeesssneesseogre 
@vesnerere 
POP RE SEO OHHH EEO HEH ORES ETE REDE He dEEeERID 
POOH TE Ree eee ser TEU HLEH TOMES ELE EEE OTH O HERE OIe 
eeve 
COO eee eee steeevresoeserdnia 
tore 
COOP a eeseraneseeeseereare 


COSHH eee eae Her eet H Ra eTeHHEHOREH HEE EEE ORE REOAIE 


mount 
mounted file system table 
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mv a troff macro package for ...........0..... mv(5) 

PING scatters sid tres coencen is Went anunaeesac mvdir(im) 
NAME GEVNM oo... eccecccceteceeeeeeseseeeeeeees devnm(im) 
name for a temporary file tmpnam ......... tmpnam(3S) 
name for common object file ...........000.. Idgetname(3X) 
name for terminal ctermid ..........00...00. ctermid(3S) 
name from UID getpw ............ eee getpw(3C) 
Naine GElENV? scan cicadas getenv(3C) 
NAME GetlOGiN oo... ccc cecessecseesceeees getlogin(3C) 


Name list nist .......... cee cceceeceeeeeeees nlist(3C) 
name list of common object file ............. nm(1) 
NaMe lOGNAME 00... cece eeeetteeeeeeee logname(1) 
NAME MKTEMP 00... eee cccescteeteereeeeens mktemp(3C) 


name of a terminal ttyname ............00... ttyname(3C) 
name of current UNIX system 0.0.0... uname(1) 
name of current UNIX system ................ uname(2) 


name of the terminal tty 0... ee tty(1) 


name of the user cuserid ................0008 cuserid(3S) 
name of user lognaMe ......... eee ceeees logname(3X) 
NANG OW: asain decmcnaiaciawacinars pwd(1) 
names and statistics for a file... ff(1m) 
NAMES DASENAME ou... eee ceeeesseseeneenees basename(1) 
names for terminals term .......... eee term(5) 
names from i-numbers ncheck .............. ncheck(1m) 
WMaAMCS IG- seccrsistccssiciatatueitoactventewhvcder id(1) 

natural logarithm intrinsic... log(3F) 
NCHECK: sezaietesiniaisundccgarcuvesaatememeasst ncheck(1m) 
nearest integer functions round ............. round(3F) 
neqn eqnchar special ........... cess eqnchar(5) 
NOT*CXOCUIO: ai Aimtnyeniciusees tunis net(1) 


NOIWOME NOE | sire vecusted hticiade ete wats detaseerenst net(1) 


network useful with graphical ........000.0.. stat(1) 
MNEtTWOrK UUSUD 00.0.0... ceccceeceseeeettseeeeeeees uusub(1m) 
ROWIOUN adcescienseiceteicconsnacess otis newform(1) 
NEWOID a ce aie naan newgrp(1) 
NEWS ItTEMS NEWS ......... eee ec eeeeeerteteeaes news(1) 
nice change priority of a2 oe nice(2s) 
PICS icstescstceceasuadew sista et oente adele nice(1) 
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PLINT. DANU. iiaterafusitearurasuac\veerisaatindenaugtees nm(1) 
nohup run a COMMANA oo... cee nohup(1) 
nroff documents for the Xerox .............. x9700(1) 
nroff format or typeset texto... ee nroff(1) 
OT OF TOU se iscticasisueeteeeaveave tbl(1) 
nroff/MM document compatibility ............ mmiint(1) 
nroff/troff, tol, ANG EQN we eee deroff(1) 
UI FNS: UE ae ees ssasioneeuciicraseeavaaeeannseiins null(7) 


number entries in a common object ...... linenum(4) 
number entries of a common object ...... Idiread(3X) 


number entries of a section of ............ Idiseek(3X) 
NUMDEr 1ACIOP itcissececsrieketcteteicdccandeceadts factor(1) 
number facts arithmetic... ee arithm etic(6) 
number generator rand ....... eee rand(3F) 
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section of a common 

a symbol table entry of a common 
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print name list of common 
information for a common 
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directories cpset install 
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print section sizes of common 
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od 

text for otroff 


octal dump 
mdial dial the P/75 
reading Idopen 
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open 
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open for reading or writing 
profiler 

terminal independent 
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message control 
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semaphore control 
semaphore 

shared memory control 
shared memory 
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number info from a common... strip(1) 
number of free disk blocks df... df(1m) 


number strtod convert ......... cece strtod(3C) 
number to String ECVE ooo... ce ceeeees ecvt(3C) 
numbering filter Ml oc eeeneees ni(1) 
numbers drand48 uniformly ...............5. drand48(3C) 
numbers frexp manipulate ..................0. frexp(3S) 
numerical commands graphics .............. graphics(1) 
object file access routines Idfcn ............. Idfcn(4) 
Object file (UMP oo... eter eeees dump(1) 
object file for reading Idopen ................. Idopen(3X) 
object file function Idlread ............0....8. Idiread(3X) 


Object file IdClOSE ........ cere eeeeeeee Idclose(3X) 


object file Idfnread oo... eee Idfhread(3X) 
object file Idlseek line number ............... Idiseek(3X) 
object file Idohseek seek to the ............. Idohseek(3X) 
object file Idrseek relocation ............00.. Idrseek(3X) 
object file ldshread ......... eee Idshread(3X) 
object file Idsseek ......... eee Idsseek(3X) 
object file Idtbindex index of ................. Idtbindex(3X) 
object file \dtbread an indexed .............. Idtbread(3X) 
object file Idtoseek seek ............0.0. Idtbseek(3X) 
Object file HINENUM oo... cece eeee ees linenum(4) 
ODIOCI ME AN ste aeeendertiarecearance: nm(1) 

object file reloc relocation ..........0.0..00. reloc(4) 


ODIECt Tile SCANGN scl witcten cis seedtosin vs Recsks scnhdr(4) 


object file strip and line ...0... hepteee strip(1) | 
object file symbol table entry ................. Idgetname(3X) — 
object file symbol table format ...... ieee syms(4) 

object files filehdr oo... ccc eeeteeeee filendr(4) 

object files in binary .......... ee cpset(im) 

OD SCENES IC, «asus rciletiecaidcind vecsae bier eaayanes Id(1) 

ODjECt MlGS SIZE: hse nGai BAe iecencs size(1) 

object library lorder ooo... eee eeeeeee lorder(1) 

OG al QUID ci otet cetadarccsdeseaisrecdceuetpueraees od(8) 

ocw prepare constant-width .................. ocw(1) 

Od Octal GUND vssicnicawiaaiielonveanuieess od(8) 

OG ae eres ha eT astdaeiitns sa cncn nie ten ucts od(1) 

Onboard MOdEM ......... ec cccccceeeeeeereeenseees dial(1) 

open a common object file for ............... Idopen(3X) 
open a stream fOpen .............ceeeeeeee fopen(3S) 


open file descriptor dup «uu... eee dup(2) 


open for reading or writing 00... open(2) 
open for reading or writing ..............08. open(2s) 
OPC: coed icetea ret nteihemr etd rytiads dade tiainds open(2) 
operating system profiler 0... profiler(1m) 


OPEration OUTINGS ......... cesses eeeesenes termlib(3c) 


OperationS MEMOTY ........ eee eneteee memory(3C) 
OperationS MSGCHl 0... eee neces msqgcti(2) 
OperationS MSGOP ......... eee msgop(2) 
Operations SEMCH oo... eee eters semcti(2) 
OPErationS SEMOP 0... ce eceneeees semop(2) 
Operations SMMC oo... eee ete ees shmcti(2) 
OperationS SHMOP ........ ee eteeteees shmop(2) 
Operations String ......... eee eeeeeee string(3C) 
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ONEIAlOl JOIN: x uterine etd eewstacscha tends: join(1) 
optimal access time dcopy .......... dcopy(im) 
optimization package curses ............00. curses(3X) 
option letter from argument ou... getopt(3C) 
optional file header of a common .......... Idohseek(3X) 
OOUOMS ACAI sc sdecasneicnasacenduscensein sast ngacmenarces fentl(5) 
options for a terminal stty oe, stty(1) 
Options ‘QClOl sn cake ected getopt(1) 
ordering relation for an object ............... lorder(1) 
Ordinary file MKNO .......... cee ceeees mknod(2) 


OUT OCW en siredor shrine sal taani de ocw(1) 


out-going terminal line ............ ce dial(3C) 
QUIDUT ArOUl xc ess 5sas vansind tartar tea teen a.out(4) 
Output interpreter 00... eee eeeeneeee tc(1) 

OUtpUt IANQUAGE ......... eee reeceee ees eeeeeeens troff(5) 
output of a varargs argument list ........... vprintf(3S) 
QUTDUR DOU 5h cccoesinainiaiee cacti eaters dumkeoane printf(3S) 
overview of accounting and... acct(1m) 
owner and group of a file chown ........... chown(2) 
owner Or group CNOWN ......... ees chown(1) 
DECK tects umitatteendenea tena iesaaeamecies pack(1) 
package curseS CRT 0... eres curses(3X) 
package for making view graphs ........... mv(7) 
DACKAGS’ Sal sscscee ascetic naieicsiniotvaeans sar(1m) 
DACKANE SIdiO: sisson seein ae stdio(3S) 
package stdipc standard ........ stdipc(3C) 
paginator for the TEKTRONIX ................ 4014(1) 
parallel port interface ......... ee pp(7) 

parent process IDs getpid ..............00. getpid(2) 
parse command options getopt .............. getopt(1) 
part intrinsic function aint ....0.. aint(3F) 

part of a file tail 00 cece eee tail(1) 

part of complex argument aimag ........... aimag(3F) 
parts of an object file dump .................8. dump(1) 
parts of floating-point numbers ............... frexp(3S) 
DASS WU 55 dseitesst ales Datisaaanse tard nee nocueavenetat ss passwd(1) 
DASSWG sescnctsivxieshusontuanlytatarscrauh lees ssieacnaaes passwd(4) 
password file entry getpwent ................. getpwent(3C) 
password file entry putpwent .................. putpwent(3C) 
password file paSSwd ou... eee passwd(4) 
PASSWOrd GEtPASS oo. ee eres getpass(3C) 
DASSWOId PASSWA on... eee ee eee e ees passwd(1) 
password/group file checkers ................. pwck(1m) 
paste lines of several files 0.0... paste(1) 
path names basename .......... basename(1) 
path-name of current working ................ getcwd(3C) 
pathname permissions file .......0... USERFILE(4) 
DANO Ql: isjcnisynderieteinecosiavedaveawcnces grep(1) 
pattern scanning and processing ........... awk(1) 
DAS es esairrcteiptrl tasted etna suid equasiarnuataaaitaensas pause(2) 
per-process accounting file oe, acct(4) 
per-process accounting records ............. acctcms(im) 
permissions file... ceeeeeceeeeeeteettee USERFILE(4) 
permit or deny messages mesg ............ mesg(1) 
permuted index ptK ....... cece eee ptx(1) 
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prepare execution profile oe monitor(3C) 
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print section sizes of common ................ size(1) 
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getpid get 

process group, and parent 
errpt 

errors errpt 

enable or disable 

acctcom search and print 
set a 

get 

init 

timex time a command; report 
terminate 

create a new 

set 

IDs getpid get process, 
script for the init 

terminate a 

change priority of a 

kill send a signal to a 
initiate pipe to/from a 
report 

get process and child 

wait for child 


| ‘ 
(_ 


suspend 

await completion of 

exit terminate 

nice change priority of a 
parent process IDs getpid get 
plock lock 

list of file systems 

signal to a process or a group of 
kill all active 

structure fuser identify 
pattern scanning and 
terminate all 

interactive message 

macro 

double precision 

display profile data 

profile within a function 
execution time profile 

display 

prepare execution 
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print/check documents formatted ........... mm(1) 
printer Ip send/cancel oo... eee Ip(1) 
printer prepare nroff oo... eee x9700(1) 
printer prepare troff oo. eereees dx9700(1) 
Printers Enable ........... cc ccceesesesecetserees enable(1) 
PRI EE sisp i betta t aesestet actaraianesuneistace aa padeedaete printf(3S) 
DRITING), weirs teicelne alsedenens tannic tetaencreoat ute lphold(1) 
prioritize print QUEUE ooo... eee topq(im) 
DHOMY NICE: ccrd avert aineaadteroaevicdeans nice(1) 
priority of a process NiC@ oo... nice(2) 
priority Of A PrOCESS ooo cece eeeeee nice(2s) 
procedure checkall ...........cccccccceeeeees checkall(1m) 
DPOCESS ID isis oiseioaceamoieadenlactans eaxseiseonid getpid(2s) 
process IDs getpid get process, ............ getpid(2) 
process a report of logged errors ........... errpt(1m) 
process a report of logged |... errpt(1m) 
process accounting ACCt oe acct(2) 
process accounting file(S) 0.0... acctcom(1) 
process alarm clock alarm ....... alarm (2) 
process and child process times ............ times(2) 
process control initialization ............... init(4m) 
process data and system activity ........... timex(1) 
DIOCESS OXIME ioc etait nes geadienedsina vane exit(2) 
DIOCOSS TOME: cciadausicenantidtecccndeaiccuietn ewe fork(2) 


process group ID Setpgrp ...... ccc setpgrp(2) 


process group, and parent process ....... getpid(2) 
PFOCESS INIA sect eeteeteeeens inittab(4) 
PIOCOSS. KIN: asics: ite nniviesetovtecanceen davai eee kill(1) 
DIOCESS NICE .cctinccstnironc titers nice(2) 
process or a group of processes ........... kill(2) 
PYOCESS POPEN oo... cect cteeteetseteneeees popen(3S) 
DIOCESS StatUS PS ooo... ee te eteees ps(1) 
PYOCESS TIMES .......ecceecceseseceeetseeeerseeereees times(2) 


process to stop or terminate wait ........... wait(2) 


process trace ptrace ........ ee saci ptrace(2) 
process until signal pause ............. eee pause(2) 
PrOCeSS Wit owes Nisin teumes, wait(1) 
DIOCOSS ~ sceuatasimineniang iene asennreas exit(2s) 
DIOCESS iver entree nice(2s) 
process, process group, and ........ getpid(2) 
process, text, or data in memory ........... plock(2) 
processed by fsck checklist 0... checklist(4) 
processes kill SENd @ oe eee kill(2) 
processes Killall 0.0... ec ceserneteeeee killall(1m) 
processes using a file or file 0.0... fuser(1m) 
processing language awk .............. awk(1) 
ProcesSing SHUKOWN oo... ee eeeeeees shutdown(1m) 
processing system mailx .0..... eee mailx(1) 
DIOCESSOF 4 ii cicissseuyvisacasiiuimnne m4(1) 
product intrinsic function dprod .............. dprod(3F) 
DlOM sisirscsintotenctacsic vie aimaaiheeineninanel omen prof(1) 
DION sii oor rater tense aanaee enanes prof(5) 
OPO Ns si ccoastesensit.ti3 a arcatavaiaemateeaanas profil(2) 
profile data prof 0... eee r ners prof(1) 
Profle MOMITON oo. ccc ce testeeseeeneees monitor(3C) 
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execution time 
environment at login time 


up an environment at login time 
disk access 

operating system profiler 
terminate Fortran 

verify 

Cc 

aC 

generate C 

C 

Ist locations in 

for getargv display a 
side-by-side difference 
conversion 

the standard/restricted command 
for modest-sized 

lex generate 

update, and regenerate groups of 
arithmetic 


print an SCCS file 
report process status 
generate uniformly distributed 


process trace 
permuted index 
copy uuto 

' stream ungetc 


stream putc 

or add value to environment 
write password file entry 

put a string on a stream 
password/group file checkers 
“working directory name 
quicker sort 


get message 
topq prioritize print 
memory id remove a message 


a command immune to hangups and 
test your knowledge 


simple random-number generator 
random number generator 

simple 

rational Fortran dialect 

split £77, 


entry of a common object file 
header of a common object file 
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DFOTIG: DION Acer cco aid nmeereanient ceoae profil(2) 
profile Setting UD AN oo... eccceceeeesteees profile(5) 
profile within a function prof... prof(5) 
DFOUIS “SOM cccicsvecvbecssacternsacdcesveudeetanened profile(4) 
DIOL SAID: sce sicuesvaipercsvavecanstsanteghedsiadier sadp(1m) 
DION G cca ittsns ths aneehFaccos putes mesa eateoneaenes profiler(1m) 
DFOGFAM: ADO ePidinsicsisapecacsedcetecsteeneewe abort(3F) 
program assertion assetft ........ assert(3X) 
program beautifier CD oo... eee cb(1) 
program checker lint «0.0... ee lint(1) 
program cross-reference cxref .............. cxref(1) 
program debugger ctrace ....... ctrace(1) 
PFOOKAM: GN ox cesnesucirataesoe Wena end(3C) 
program name and get argumerts ........ getargv(2s) 
DFOGIANY SIN «ais iniernetasdenecsocinanariens eens sdiff(1) 
Program: UNANS .cculuai due neiniae ed: units(1) 
programming language sh shell, ........... sh(1) 
programs bs compiler/interpreter ........... bs(1) 
programs for simple lexical tasks ........... lex(1) 
programs make maintain, ......... ee make(1) 
provide drill in number facts ou... aritnmetic(6) 
provide truth values true... ee true(1) 

DONS ss taccacecracn ooo eainams a teaeraten tener catenins prs(1) 

DS eee rece hetero cneeewnanae. ps(1) 
pseudo-random numbers drand48 ........ drand48(3C) 
pt IMSP cartridge controller... pt(7) 

DUACE sa hetesc cat caeiiet ce tacee neon ace ptrace(2) 
DOG eg rea iceidesad a ayorseare eta Re ns: ptx(1) 

public UNIX-to-UNIX system file ............. uuto(1) 
push character back into input ............... ungetc(3S) 
put a string on a stream puts ................. puts(3S) 

put character or word ON @ ........ceeeee putc(3S) 
DULENV CHANGE ........cecccecescetteeeeeeeensees putenv(3C) 
DUIDWENE csi ciscuanincrcaceavendtetrmeemesenmeen Nile. putpwent(3C) 
UII tescarc a tects hemantnamna eiccumecstanesoeuatees puts(3S) 
DWC 206s alone oir aieniremt er eo pwek(1m) 
DW i tcecctataslte a conictaahiveuectaeavennina wad pares pwd(1) 
SOR ais tinea oe ey qsort(3C) 
query terminfo database tput ................. tput(1) 
QUCUC MSGGET .........ccececcccecceeseeeeesernenetenes msgget(2) 
QUCUG) iaccrs wsvantarenvessvedesre Gum aiaunanarenones topq(1m) 
queue, semaphore set or shared .......... ipcrm(1) 
quicker SOrt QSOFt ou... ecececeesereeeeneeeees qsort(3C) 
QUIS MOMUD CUA suseciesetieclessnepieedecerteaghahtes nohup(1) 
QUIZ SaeettusiaAangnawiende: peda VaNnaancaseeueds quiz(6) 
ramdisk memory as diSK oe ramdisk(1m) 
FANG -seccsinoeiiacen tn caianatuen rand(3C) 
PAIN: sess sted ose ae tanes ta caa nade eadatcscabegias rand(3F) 
random-number generator rand ............. rand(3C) 
PUM: cayticveccin cies Masacica crete cera sercn ratfor(1) 
ratfor, or efl files fsplit 0.0, fsplit(1) 
rational Fortran dialect ratfor ....00.0.00.... ratfor(1) 
read a password getpass ........ getpass(3C) 
read an indexed symbol table ................ Idtbread(3X) 
read an indexed/named section ............ ldshread(3X) 


- 34 - Plexus Sys 5.21 UNIX 


read 
send mail to users or 


member of an archive file 
object file Idfhread 

read from file 

move 

lseek move 

open a common object file for 
open for 

open open for 

get real and effective user, and 
get real and effective user, 
get real and errective user, 
real effective group get 
specify what to do upon 
specify Fortran action on 
from per-process accounting 
extract error 

tape frec 

regular expression compile 
and execute regular expression 
make maintain, update, and 
compile and match routines 


( \ match routines regexp 


=A regcomp 
compile and execute 

files comm select or 

lorder find ordering 

join 

for a common object file 

of a common object seek to 

common object file reloc 

functions floor, ceiling, 

mod Fortran 


uuxqt execute 

L.cmds 

spawn getty to a 

file rmdel 

semaphore set or shared memory 


constructs deroff 

consistency check and interactive 
consistency check and interactive 
report 


communication facilities 

blocks df 

process a 

system activity 

activity timex time a command; 
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read from fil€ r€Ad ......... ccc eceesecccceneeeeeeees read(2) 
FEC. MOM ME ap iad cats Goede een die: read(2s) 
read. Mall Mall. ss isscicrtecoeeteieesdeutens mail(1) 

read One line lINE ooo... eee eeeeece nee eeeeees line(1) 

read the archive header of a ............ Idahread(3X) 
read the file header of a common ......... Idfhread(3X) 
FO AG eckicisvanaiacecneveddstiietoudeny ficnien anesonen read(2) 
read/write file pointer Iseek ...............0... lseek(2) 
read/write file pointer 0.0.0.0... ecees lseek(2s) 
reading ICOPeN ©... ee eect cee enna ees Idopen(3X) 
reading or writing Open ........... ee open(2) 
reading Or WYitING 0.0... ceeeeeeeteeseeeteees open(2s) 
real and effective group ID .......... getuid(2s) 
real and effective group ID's ..........0.0.. getuid(2) 
real and effective group, ............. ee getuid(2) 
real and effective uSer, .......... ee getuid(2) 
receipt of a Signal 0... eee signal(2) 
receipt of a system signal ...........000008. signal(3F) 


records acctcms command summary ... acctcms(1m) 


records from dump errdead ...........0..0. errdead(im) 
recover files from a backup 0.0.0.0... frec(1m) 
FOOCIND) aiiatait forayieior tauiea amtbeiasade regcmp(1) 
regcomp compile ............ eteeticeceks regcmp(3X) 
regenerate groups of programs ............. make(1) 
regexp regular expression... ee. regexp(5) 
regular expression compile and ............. regexp(5) 
regular expression compile regcmp ....... regcmp(1) 
regular expression compile ...............08 regcmp(1) 
regular expression regcmp ........... regcmp(3X) 
reject lines common to two sorted ......... comm(1) 
relation for an object library oe. lorder(1) 
relational database operator .................. join(1) 
reloc relocation information ..............0.... reloc(4) 
relocation entries of a section ............... Idrseek(3X) 
relocation information for a ..........0....08 reloc(4) 
remainder, absolute value ...............0.0. floor(3M) 
remaindering intrinsic functions .............. mod(3F) 
reminder service calendar .................04 calendar(1) 
remote command requests ..............0... uuxqt(1m) 
remote execution commands ................. L.cmds(4) 
remote terminal Ct ...........cccccesceeesereeeeeeees ct(1) 


remove a delta from an SCCS ...... rmdel(1) 


remove a message queue€, ................. ipcrm(1) 
remove directory entry unlink ..........0...... unlink(2) 
remove files or directories rm ................. rm(1) 
remove nroff/troff, tbl, and egn ............... deroff(1) 
repair fsck file system 0.00.0 fsck(1m) 
repair fsck file systeM oo... es fsck(8) 
repeated lines in a file uniq ........00... uniq(1) 
report CPU time used clock ..........0...0.. clock(3C) 
report inter-PrOCSS oo... eee ee eteee ipcs(1) 
report number of free disk ............0...0. df(1m) 
report of logged errors errpt .............. errpt(1m) 
report package SAP... cece eens sar(1m) 
report process data and system ............ timex(1) 
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uniq 

system activity 

stream fseek 

requests start/stop the LP 
send/cancel 

uuxqt execute remote command 
restore 

incremental file system 

lphold postpone printing, 
object file symbol table entry 
argument getarc 

variable getenv 

mclock 

abs 

len 

substring index 

logname 

name getenv 

data 

filter 

create a new file or 

drive 

remove files or directories 
remove a delta from an SCCS file 
change 

chroot change 

logarithm, power, square 
Fortran square 

Fortran nearest integer functions 
graphical device 

common object file access 
expression compile and match 
graphical table of contents 
float and double 

as a disk 

nice 

and quits nohup 

run daily accounting 

SCCS file editing activity 

disk access profiler 

system activity graph 

system activity report 

system activity report package 
convert formatted input 

big file 

awk pattern 

programs 

two versions of an SCCS file 
format of SCCS file 

start/stop the LP request 
header for a common object file 
package curses CRT 

editor based on ex vi 

inittab 
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report process status ps 
report repeated lines in a file 
report sail 
reposition a file pointer in a 
request scheduler and move 
requests to an LP line printer Ip 
requests 
restor incremental file system 
restore 
resume printing 
retrieve symbol name for common 
return Fortran command-line 
return Fortran environment 
return Fortran time accounting 
return integer absolute value 
return length of Fortran string 
return location of Fortran 
return login name of user 
return value for environment 
returned by stat system call stat 
reverse line-feeds col 
rewrite an existing one creat 
rm Cipher Microstreamer tape 


rm 


rmdel 
root directory chroot 
root directory for a command 
root function exp exponential, 
root intrinsic function sqrt 
round 
routines and filters gdev 
routines Idfcn 
routines regexp regular 
routines toc 
routines 
rram allows memory to be used 


run 
run 


runacct 
Sact print current 
sadp 


scant 
scanner bfs 
scanning and processing lanquage 


SCC 


sccsdiff compare 
sccsfile 
scheduler and move requests 
scnhdr section 
screen handling and optimization 
screen-oriented (visual) display 
script for the init process 
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Coeeneeerneresense 
eee dees eenseacraecens 
eeerereasornces 
eee s vere seeseore 
eouerns eens oesee 
om acereearenrsredsovsene 
ee oeareseesvereececsancsnn 
Peeve everesesnasae 
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CRM meee Eee Hr ee EEH HE SEER EASE HOTEL HERE EEE RED EOE EHED 
CRO e Dee eee eeneoeneeeerereereses 
ereestareseeerecas 
eve eestesensvsce 
COR eee eeersrerennceerer 
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eceseenrerereesereraeesece 
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a command at low priority 
comm immune to hngup 


C compiler for stand-alone .............. 
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ps(1) 
uniq(1) 
sail(1) 
fseek(3S) 
Ipsched(1m) 
Ip(1) 
uuxqt(im) 
restor(8) 
restor(1m) 
Iphold(1) 
ldgetname(3X) 
getarc(3F) 
getenv(3F) 
mclock(3F) 
abs(3C) 
len(3F) 
index(3F) 
logname(3X) 
getenv(3C) 
stat(5) 
col(1) 
creat(2) 
rm(7) 

rm(1) 
rmdel(1) 
chroot(2) 
chroot(1m) 
exp(3M) 
sqrt(3F) 
round(3F) 
gdev(1) 
Idfcn(4) 
regexp(5) 
toc(1) 
float(2s) 
rram(7) 
nice(T) 
nohup(1) 
runacct(1m) 
sact(1) 
sadp(1m) 
sag(1) 
sail(1) 
sar(1m) 
scanf(3S) 
bfs(1) 
awk(1) 
scc(1) 
sccsdiff(1) 
sccsfile(4) 
lpsched(1m) 
scnhdr(4) 
curses(3X) 
vi(1) 
inittab(4) 
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system initialization shell 
side-by-side difference program 
grep 

binary 

accounting file(s) acctcom 
linear 

manage hash 

manage binary 

object file scenhdr 

file read an indexed/named 
seek to line number entries of a 
seek to relocation entries of a 
seek to an indexed/named 
files size print 

stream editor 

section of a common object 
section of a common object file 
of a common object file 
common object file Idtbseek 
get shared memory 

change data 

brk change data 

to two sorted files comm 


file cut cut out 
dump dump 
semctl 


iperm remove a message queue, 
get set of 

semaphore control operations 
get set of semaphores 
semaphore operations 

group of processes kill 

a group of processes kill 

mail 

line printer Ip 

reminder 


umask 

umask 

map of ASCII character 

execution env 

modification times utime 

umask 

get 

remove a message queue, semaphore 


stly 
print and 
stly 


stime 
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SCH DIS ONG 25. xordericancistsscadieueeeuekeireecicagees brce(im) 
SO Seiki tee ied crrcontea caesarean: sdiff(1) 
search a file for a pattern oe, grep(1) 
search a sorted table bsearch ............... bsearch(3C) 
search and print process ............cee acctcom(1) 
search and update Isearch ...............0.. lsearch(3C) 
search tables hsearch ..............cccceeee hsearch(3C) 
search trees tsearch .......... cece ceeeeees tsearch(3C) 
section header for a common ................ scnhdr(4) 
section header of a common object ...... Idshread(3X) 
section of a common object file ............. Idiseek(3X) 
section of a common object file ............. Idrseek(3X) 
section of a common object file ............. Idsseek(3X) 
section sizes of common object ............ size(1) 
SOG cnr Medea hack eaaceoeteenabnaenilateadiaa ant sed(1) 
seek to line number entries of a ............ Idiseek(3X) 
seek to relocation entries of a ................ Idrseek(3X) 
seek to the optional file header .............. \dohseek(3X) 
seek to the symbol table of a ................ Idtbseek(3X) 
SEGMENt SHMGE|? o.oo... eects eeeenees shmget(2) 
segment space allocation ork ......., brk(2) 
segment space allocation ........ ee. brk(2s) 
select or reject lines common ................ comm(1) 
select terminal filter greek o/c. greek(1) 
selected fields of each line ofa ............. cut(1) 
selected parts of an object file .......0....... dump(1) 
semaphore control operations ................ semcti(2) 
semaphore operations semoo ................ semop(2) 
semaphore set or shared memory id .... ipcrm(1) 
SeMaphoresS SEMGET ...... eee eeeeeee semget(2) 
SEMICH crear shiateleoeaea esas Re eeaivees semctl(2) 
SOMOS! eaccmisserncdsnsueuanotentaumaie semget(2) 
SOM OD i seceatieenccatncacosnauastunasnastomnareeites semop(2) 
send a signal to a process or a ............. kill{2) 
send a signal to a process Or ................ kill(2s) 
send mail to users or read mail ............. mail(1) 
send/cancel requests to an LP .............. Ip(1) 
SEMVICE CAIENAAM ooo... cccccecescesseeeeeeneees calendar(1) 
set a process alarm clock alarm ............ alarm(2) 
set and get file creation mask ................ umask(2) 
set and get file creation mask ................ umask(2s) 
SOt ASC sites a sat coachapaes siathaeantuctangerdanenceuee ascii(5) 
set environment for command. ............... env(1) 
set file ACCESS ANA oo... cece ceeteeres utime(2) 
set file-creation mode mask ...............0.. umask(1) 
set of semaphores semget .................0.. semget(2) 
set or shared memory id iperm .............. ipcrm(1) 
set process group ID setparp ................ setpgrp(2) 
set tabs on a terminal tabs ................0.. tabs(1) 
set terminal characteristics .......... stty(2s) 
set the date date 0.0... ccceseereetteeees date(1) 
set the options for a terminal ...........0... stty(1) 
SOUTMG SUMG: sssivexicscsivenaetissmsenmnes stime(2) 
SOLTMNG® sen amiacnstiticsamecnerscusanenin stime(2s) 
set user and group IDs setuid ................ setuid(2) 
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get and _ set user limits ulimit .... ee ulimit(2) 
assign buffering to a stream Setbuf oc ceeteetenneenreneentees setbuf(3S) 
establish mount table S@tMNt ..........cccccceccsceescseseeseseseeecaeeesens setmnt(1m) 
set process group ID SetPQrpP oon... ce ceeccccesteeteteeseereeeeneees setpgrp(2) 
login time profile setting up an environment at oo... profile(4) 
login time profile setting up an environment at ................. profile(5) 
speed and terminal settings used by getty gettydefs ............ gettydefs(4) 
set user and group IDS S@tUId oo... cecceeneeeteetteeeeeeeeaeees setuid(2) 
of one merge same lines of several files or subsequent lines ........... paste(1) 
command programming language sh the standard/restricted .....00.. a. sh(1) 
shmctl shared memory control operations ........ shmcti(2) 
a message queue, semaphore set or shared memory id ipcrm remove ........... ipcrm(1) 
shared memory operations shmop ........ shmop(2) 
get shared memory segment shm¢et .......... shmget(2) 
issue a shell command from Fortran sys ........... system(3F) 
issue a_ shell command system ........ ee system(3S) 
system initialization shell scriptS OFC oo... eee ceeeeeeereee bre(1m) 
command programming language sh_ shell, the standard/restricted .............0.... sh(1) 
shared memory control operations SNMCTI oo eee reeeeeeeeeeeeeeeees shmcti(2) 
get shared memory seqment SNMGET ou... ce eeetteteeeeettteeeseneaas shmget(2) 
Shared MeEMOry OperatiONS SNMOP ou... cece eeeetleeeseteeeecraeeesenes shmop(2) 
terminate all processing SNUTGOWN ou... ccceeeeenteeeeeeetteeeeeetens shutdown(1m) 
sdiff side-by-side difference program ............. sdiff(1) 
SIGN ON JOGIN: Basis nestor tueeeeninee login(1) 
intrinsic function sign Fortran transfer-of-sign .......0...00.... sign(3F) 
suspend process until Signal pPaUSE 0... eee pause(2) 
processes kill send a_ signal to a process or a group of ........... kill(2) 
processes killsend a_ signal to a process or a group of ........... kill(2s) 
on receipt of a system signal signal specify Fortran action .......00...... signal(3F) 
to do upon receipt of a signal signal specify what oo... ee signal(2) 
software signals SSIQNal 0... cee ceeereteeeee ssignal(3C) 
generate programs for simple lexical tasks lex oe lex(1) 
troff preprocessor for drawing simple pictureS PIC eee pic(1) 
rand simple random-number generator .......... rand(3C) 
Fortran sine intrinsic function Sin oe. sin(SF) 
Fortran hyperbolic sine intrinsic function sinh... sinh(3F) 
AYPErbolic FUNCTIONS SIN oo... ees cesttecseseesceensnecsseseesentseeenenes sinh(3M) 
sine intrinsic function sinh Fortran hyperbolic oe. sinh(3F) 
print section sizes of common object files size .......... size(1) 
interval sleep suspend execution for ................ sleep(2s) 
suspend execution for an interval SICOP oe ects cece ceeerereenteees sleep(1) 
suspend execution for interval SIC@D oo... cece rece et rene enneenees sleep(3C) 
for typesetting viewgraphs and _ slides a troff macro package ................ mv(5) 
documents, viewgraphs, and _ slides mmt typeset ........... cers mmt(1) 
current user ttyslot find the slot in the utmp file of the ow, ttyslot(3C) 
interpolate smooth curve spliné ........eee spline(1) 
SNOBOL interpreter SNO oo... cccessceseeeeteeetestseeseesieenseetaes sno(1) 
file perusal filter for soft-copy terminals pg ....... ee pq(1) 
software signals ssignal ..............e ssignal(3C) 
sort and/or merge files sort .................. sort(1) 
QUIGKEr “SOI SOM eccicicieuatianesseneeirednittien qsort(3C) 
topological SOM tSOMM cicsciciisccesveesaisicieisectensserieee, tsort(1) 
or reject lines common to two sorted files comm select ............0..00 comm(1) 
binary search a_ sorted table bsearch oes bsearch(3C) 


change data segment space allocation Ork ....... eee brk(2) 
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brk change data segment 
terminal ct 

for eqn and neqn eqnchar 
build 

create a new 

mknod make a 

300s terminals 300 handle 
2621-series terminals handle 
terminal 450 handle 

make a directory or a 
format 

isatty returns a 1 if 

of a system signal signal 
of a signal signal 

by getty gettydefs 

find 

interpolate smooth curve 


context 

fsplit 

uUCp 

configure the LP 

in a machine-independent fashion. 
square root intrinsic function 
exponential, logarithm, power, 

sqrt Fortran 

file number on a tape 


aren 


compatibility checker mmiint 
software signals 

scc C compiler for 

package stdio 

communication package stdipc 
programming shell, the 
scheduler and move requests 


data returned by 

get file status 

data returned by stat system call 
useful with graphical commands 
graphical commands stat 

list file names and 

get file system 

ustat get file system 

print LP 

stream 

uustat uucp 

communication facilities 

System control and 

report process 

get file 

stat get file 

buffered input/output package 
communication package 
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Space allOCation .0.... cece ceeeeeeees brk(2s) 
spawn getty to a remote ...... ee, ct(1) 
special character definitions .........0..0... eqnchar(5) 
special file MKNOD ..........c cs eeeteteeecccovesees mknod(1m) 
SPCC aN TS. oi. kiccacn tasaacheucenems aus teaaaaderess creat(2s) 
SPCC TS. 5.5 evs sacarrtnsavecatonsnadmeemeisnentatodss mknod(2s) 
special functions of DAS! 300 and ......... 300(1) 
special functions of HP 2640 and .......... hp(1) 
special functions of the DAS! 450 .......... 450(1) 
special or ordinary file mknod ................ mknod(2) 
specification in text files fspec .........0..... fspec(4) 
specified file descriptor is a oe isatty(2s) 
specify Fortran action on receipt ............ signal(3F) 
specify what to do upon receipt ............. signal(2) 
speed and terminal settings used .......... gettydefs(4) 
spelling errors spell 0... eens spell(1) 
SUNS asec cg seaay see eiccsesencet nteseeas spline(1) 
split a file into pieces split 0... split(1) 

Slt CSDM siceccatea este ersuaxientistoudaren csplit(1) 
split f77, ratfor, or efi files 0. fsplit(1) 
spool directory clean-up uuclean ........... uuclean(1m) 
spooling system iIpadMin 0... lpadmin(1m) 
sputl access long integer data ............... sputl(3X) 
SOits OMA acter crncetads caret aster avnGideaes sqrt(3F) 
square root function exp ...... ee exp(3M) 
square root intrinsic function ........ pcaieaes sqrt(3F) 
srcheof position to a specific... srcheof(2s) 
SrOn: TOMMNAL 1OXt iaecueisnculalincettsi aden sroff(1) 
sroff/MM nroff/MM documert ................. mmiint(1) 
SSIDM AN chases cetenesictisssusdersssiaicstanseotencatictans ssignal(3C) 
Stand-alone programs ou... ees scc(1) 
standard buffered input/output ............... stdio(3S) 
Standard interproceSs oo... eee stdipc(3C) 
standard/restricted command ............... sh(1) 
start/stop the LP request ........ ee lpsched(1m) 
Stat get file statuS 0... eeeetee stat(2s) 
stat system call Stat 0... eeeeee stat(5) 

SA. ivisarnasaaas coattarar iru tenvasis caste laomehes stat(2) 

Stal: greta entices eee aaa stat(5) 

stat statistical network oe stat(1) 
statistical network useful with oo... stat(1) 
Statistics for a file system ff... ff(1m) 
SIATISIICS USISN sacitetieitencaccnitoruencucenirnens ustat(2) 
StaliShCS: ccciisieceiarcaste dnt testeentaneatensdes ustat(2s) 
status information Ipstat ...0 ee lpstat( 1) 


ts 
@ 
3 
[e) 
=~ 
w 
L 


status inquiries ferror 


status inquiry and job control ............... uustat(1) 
status ipcs report inter-process .............. ipcs(1) 
StaluS DrOGrany cco een pneess sys(1m) 
SIglUS DS S4.Gciccs erento ps(1) 
SlatUS Slat: pcrncsalinrancnnceuparuniuticasinces stat(2) 
Stal Sci. cocwiclecsetetauseueee ag cametomeen tented stat(2s) 
SIGIO: SIAN ANA sedis cssrcasacteekrseitennsesaeaees stdio(3S) 
stdipc standard interprocess ................. Stdipc(3C) 
STIME Set TIME .0.... ec ce cecce eee eeeteeenes stime(2s) 
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set time 
wait for child process to 
comparision intrinsic functions 


close or flush a 

open a 

reposition a file pointer in a 
get character or word from a 
get a string from a 

put character or word on a 
put a string on a 

assign buffering to a 


push character back into input 
ft IMSP 

long integer and base-64 ASCII 
functions strcmp 

convert date and time to 
convert floating-point number to 
get a 

return length of Fortran 

put a 


striod convert 

convert 

string operations 

gps graphical primitive 
information from a common 

from a common object file 

string to double-precision number 
convert string to integer 
processes using a file or file 
characteristics 

set the options for a terminal 
become super-user or another user 
graphics interface 

same lines of several files or 
return location of Fortran 

and block count of a file 


du 

accounting records command 
update the 

update 

become 

document analyze 

interval sleep 

sleep 

sleep 

pause 

swap bytes 

information from a strip 

file symbol table retrieve 
name for common object file 
object compute the index of a 
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SUG ccconntecosticuen tnaeeniateemaaennnaons stime(2) ON 
stop or terminate Wait oes wait(2) 
SUCMPSWING isesrwincssoecesraartagdeavucenaevtouts stromp(3F) 

Stream editor SE oo... ccceetereeeennees sed(1) 

StS AM IClOSE? caisetasnicrioas yal idpardntapensioncaans fclose(3S) 

SIPEG aIN TODO Sieedreceiiacthiieeceatelsae enone fopen(3S) 

StrOaM [SOK si asicsisiicierccens aes eiteventvastenvess fseek(3S) 

SIGS GSC: F ecsincie cet hieeeawioromadeiares getc(3S) 

Siream) OGlS .oucrusg Grenada gets(3S) 

STEAM UIC a arcmicnnacear awn dsnuiby: putc(3S) 

SUE AIM OLS scaissaicsin teat yatdeaiucuneseduadateanetaincane puts(3S) 

Stream Setouf .......cccccecetaseeeeenens setbuf(3S) 

stream status inquiries ferror .................. ferror(3S) 

STEAM UNGEIC ooo... ecceccccceecettecctsreeetsaees ungetc(3S) 

streaming cartridge controller ..........0...... ft(7) 

string a64l convert between ............... a64I(3C) 

string comparision intrinsic 0.0.0.0... strcmp(3F) 

St Ct erates rigtt Roar Meteatee ctime(3C) 

SUNN COVE coer cesiueptateasaanitinantends ecvt(3C) 

string from a stream getS ........ ee gets(3S) 

SING NSN: tesiiercceeesegesteasronstracharentseowete: len(3F) 

String On a Stream putS oo... eens puts(3S) 

String operations String ......... eee string(3C) 

string to double-precision number ......... strtod(3C) 

string to integer Strtol oo... ee strtol(3C) 

SITING rsicact ee reeentetss eerie ietaes eras string(3C) ‘ 
string, format of graphical files ............... gps(4) : 
strip symbol and line number ................. strip(1) S/S 
strip line number information ...0...0..000. strip(1) 

SMOG CONVE xcuaatncmti ese eiauuedsices strtod(3C) 

SIMO ae cetacean inanitianemattamine striol(3C) 

structure fuser identify 0. eens fuser(1m) 

Stty set terMinal 0.0... ceceeeteeeeeeens stty(2s) 

SEY: sickcs aeisaiastaseint sewed ete cet aeraumenenekt stty(1) 

SU * pscatiauia cient seestorminunsaicheaneasedss su(1) 

SUDFOUTINGS POT oo. cee er eeeeens plot(3X) 

subsequent lines of one file... paste(1) 

SUDSTFING INGEX ooo. cece ese cseseseeeseneees index(3F) 

SUM print CHECKSUM ........ eens sum(1) 

summarize disk usage du oe du(1) 

summarize disk USAde@ .......... eee du(8) 

summary from per-process ............... acctcms(1m) 

Super DIOCK SYNC oo... cecee ec eeeeeeees sync(1) 

super-block SYNC oo... eee sine Rented sync(2) 

super-user or another user su ............... su(1) 

surface characteristics of a oe. style(1) 

suspend execution for an ou... sleep(1) 

suspend execution for interval 0.0.0.0... sleep(2s) 

suspend execution for interval ............... sleep(3C) 

suspend process until Signal ...........00.. pause(2) 

SW Aiba ciais cesses atinadch orto pendncsie acetate swab(3C) 

symbol and line number oe strip(1) , Ss 
symbol name for common object .......... Idgetname(3X): : 
symbol table entry Idgetname ................ Idgetname(3X) © 
symbol table entry of a common ........... Idtbindex(3X) 
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object file read an indexed 
common object file 

file Idtbseek seek to the 
object file symbol table format 
update the super block 
update super-block 


XN 


Sar 


command; report process data and 
daily/weekly UNIX system file 

data returned by stat 

exercise link and unlink 

checkall faster file 

UNIX-to-UNIX 

interactive repair fsck file 

interactive repair fsck file 

file ioctl.syscon 

UNIX system to UNIX 

what to do when the 

call another UNIX 

primitive 

file 

fsdb file 

,” names and statistics for a file 
public UNIX-to-UNIX 

filesave daily/weekly UNIX 
examine 

scripts brc 

configure the LP spooling 
interactive message processing 
construct a file 

mount and dismount file 

- mount a file 

operating 

incremental file 

Fortran action on receipt of a 
get file 

ustat get file 

mounted file 

UNIX 

unmount a file 

print name of current UNIX 
get name of current UNIX 
format of 

who is on the 

mount a file 

issue a shell command 

a shell command from Fortran 
dcopy copy file 

checklist list of file 

volcopy copy file 

binary search a sorted 

for common object file symbol 
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symbol table entry of a common ........... Idtbread(3X) 
symbol table format SyMS_ .........c ee syms(4) 
symbol table of a common object .......... Idtbseek(3X) 
SVMS COMIMON: “Ssctonsicsndcnmrassaetcod eee syms(4) 
SVC ic wiosasecin ta aetiah cman era ne dees sync(1) 
SINC cette ai acetone lc omtmeaod onode inant Gunes sync(2) 
system activity graph Sag ....... ee s$agq(1) 
system activity report package ............... sar(1m) 
system activity report Sail oe, sail(1) 
system activity timex time a... a. timex(1) 
system backup filesave oo... eee filesave(1m) 


SVSIOM ‘Call: SIAC wc dsaaits onc ceosaglan cunemeasins stat(5) 


SyStem Calls link oo eeeeeeees link(1m) 
system checking procedure .................. checkall(1m) 
system command execution uux ........... uux(1) 
system consistency check and .............. fsck(1m) 
system consistency check and .............. fsck(8) 
system console configuration ................ ioctl. syscon(4) 
SYSTEM COPY UUCD oe eee uucp(1) 
system crashes crash oe crash(8) 
SVSICM CUl scztasostae Seared enema cu(1) 
system data types types oe types(5) 
system debugger fSdb ou... ees fsdb(1m) 
SysteM GeEDUGGEr .....eeee erent fsdb(8) 
system error messages perror ............... perror(3C) 
system ff list fil@ 0... eteeeee ff(1m) 
system file Copy UUtO ..... ees uuto(1) 
system file system backup ..............06. filesave(1m) 
system images crash... eee crash(1m) 
system initialization shell... brc(im) 
SySteM |IPAadMIN ............cccccesssssseeeseesereees lpadmin(1m) 
SYSIOM Mai cess bnarsaeimaerade mailx(1) 
SYSISM: MKS sas ris hevesiidicesteaneieeneaum mkfs(1m) 
SYSTEM MOUNT oedescisssscscidinecdeiesammavectoens mount(1m) 
SYSTEM: MOUN! Sc.shrciaciecarAcdnai es mount(2) 
system profiler profiler 0.0.0... profiler(im) 
SYSTEM FEStOLe oo... ccceceseseeeeteteeeenes restor(1m) 
system signal signal specify ........0.000.. signal(3F) 
system statistics ustat oo... ee ustat(2) 
system statistics .......... fli sas dio dsoueetiaealte ustat(2s) 
system table mnttab ..0.... eee mnttab(4) 
system to UNIX system copy uucp ........ uucp(1) 
SYSTEM UMOUNT 000... eccceceeeee teeeeees umount(2) 
SYSTEM UNAME ou... ccccccecceeeeceesceeeenenes uname(1) 
SYSTEM UNAME .......cccccccceceeeeeeeerttreetaes uname(2) 
SYSTEM VOIUME FS oo... ccc eeeerteseeeenees fs(4) 

SVSIOMT WO. tenncciestd naresteeose ne eomietunits who(1) 
SUSIC I isidep deer eterprocuaaizainanediiaciean mount(2s) 
SYSIOIW crac asscentcieresssntuaeenelnceseaccansenins system(3S) 
SYSTEM ISSUC ......c ec cccccesssecccnsesetareeeceees system(3F) 
systems for optimal access time ............ dcopy(1m) 
systems processed by fsck ....... checklist(4) 
systems with label checking ......000000000. volcopy(1m) 
fablO DSCAICN salicanaiscaccisetareehaiieokeane bsearch(3C) 
table entry Idgetname name .................. Idgetname(3X) 
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compute the index of a symbol 
file read an indexed symbol 
common object file symbol 
mounted file system 
Idtbseek seek to the symbol 
graphical 

establish mount 

tb! format 

manage hash search 

set tabs on a terminal 
deliver the last part of a file 
Fortran 

tangent intrinsic function 
fbackup make a fast 
fobackup make a fast 

rm Cipher Microstreamer 


dump incremental dump 
recover files from a backup 
tape file archiver 

programs for simple lexical 
| troff 

deroff remove nroff/troff, 


of a file pointer 

create a 

create a name for a 

format of compiled term file. 
conventional names for terminals 
data base 

paginator for the TEKTRONIX 4014 
special functions of the DASI 450 
EOT on the other 

termcap 

terminfo 

gtty get 

stty set 

spawn getty to a remote 
generate file name for 

select 

routines termlib 

controlling 

tty general 

establish an out-going 

gettydefs speed and 

set the options for a 

set tabs on a 

get the name of the 

find name of a 

ttytype data base of 

functions of DASI 300 and 300s 
of HP 2640 and 2621-series 

file perusal filter for soft-copy 
conventional names for 
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table entry of a common object ............. Idtbindex(3X) 
table entry of a common object ............. Idtbread(3X) 
table format SYMS 0... ceereeteeees syms(4) 
table: MINA: ec ewrisaeeies Noeea tee eeetenses mnttab(4) 
table of a common object file ...... i. Idtbseek(3X) 
table of contents routines toc ............ toc(1) 
lable SOINNY tcniiienctiinnwnedeniieives setmnt(1m) 
tables for nroff Or troff oo. eee eeeeeees tbi(1) 
tables NS@arch ooo... ccc cecesseereeeteees hsearch(3C) 
NDS sasecaldens Ben Matec ya aewidaaties aeammananeteon an tabs(1) 
[21] ney anes nee tte ee anne coer tail(1) 
tangent intrinsic function tan 0... tan(3F) 
tanh Fortran hyperbolic ................cce tanh(3F) 
tape backup of a file system... foackup(1m) 
tape backup ofa file system... foackup(8) 
TADS IVE: seston ccnicsditnatasasaieniue tilenteietes rm(7) 
tape file archiver taro... eee tar(1) 
TAPS TON AT ics cara eerin cerita moreno: dump(4) 
lapO TOC alec eae frec(1m) 
TAP Saccass iit utes cee aca cnoeasnaioateem ices ues tar(1) 
tasks lex Generate oo... cet eeeeeeees lex(1) 
tb! format tables for nroff or .............08. tbl(1) 
tbl, and eqn constructs... ee deroff(1) 

te troff output interpreter oe tc(1) 
tell report the current value... tell(2s) 
temporary file tmpfile oo... tmpfile(3S) 
temporary file tMpnamM oo... eee tmpnam(3S) 
TOUIN swt icencatecndacmoetaasadedeanmeacunltepeisach iat enaters term(4) 
TOI: Sezecdeissh Gn trnedtrri oe uten nto mest ieaan, term(5) 
termcap terminal capability .......0.0..00. termcap(4) 
terminal 4014 oo... ccecccceecesesesssaeeeseees 4014(1) 
terminal 450 handle 0. eee 450(1) 
terminal and exits. write ............ cee write(1) 
terminal capability data base ...............0.. termcap(4) 
terminal capability data base ...........000.. terminfo(4) 
terminal characterisitcs ................ccccee gtty(2s) 
terminal Characteristics ............cceeeeeeee stty(2s) 
TOMMIR ACH ccctationcresivcscsscncinectaledear eee’ ct(1) 
terminal CterMid ...........ccccceescesensceeeeesees ctermid(3S) 
terminal filter Greek eee eeeeee greek(1) 
terminal independent operation .............. termlib(3c) 


terminal interface tty 0.0... eee tty(7) 


terminal interface oo... cece eeeeees tty(7) 
terminal line connection dial ................... dial(3C) 
terminal settings used by getty .............. gettydefs(4) 
TEFMINAUSHY aucsids hacsaseatcestans maecvaalisavosnswates stty(1) 
terminal tabs 2.0... eeetetesseeees tabs(1) 
TOMIMIN AY, scares tev eta ti dstanesbdeeategect tty(1) 
terminal tlYNAME ....... cece ee eeteees ttyname(3C) 
terminal types by port ........... eee ttytype(5) 
terminals 300 handle special ................. 300(1) 
terminals hp special functions ................ hp(1) 
TOCMINGAIS: DO icp asaketods cainivo do disrsnostaneessaiens pg(1) 
TErMinalS terM .......ceeseeeeeceeeeesees term(5) 
terminate Fortran program abort ............ abort(3F) 
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shutdown 


exit 
daemon errstop 
wait for child process to stop or 


query 

terminal capability data base 
operation routines 

command 


condition evaluation command 


casual users edit 

change the format of a 
format specification in 

eqn format mathematical 
ocw prepare constant-width 
troff 

nroff format or typeset 

sroff format 

lock process, 


wump 
terminfo compiler 


data and system activity timex 
update access and modification 
set file access and modification 
get process and child process 
process data and system activity 
create a temporary file 

a name for a temporary file 
initiate pipe 

table of contents routines 


merge or add 

and modification times of a file 
7 graphics filters 
query terminfo database 
translate characters 

process 

function sign Fortran 


system uucico file 
walk a file 
manage binary search 
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terminate a process Kill oe, kill(1) 
terminate all processing «0.0... shutdown(1m) 
terminate process eXit 0... ees exit(2) 
terminate PrOCeSS oo... eeeeeeees exit(2s) 
terminate the error-logging ........0.....0068. errstop(1m) 
terminate Wait oo... ccc cee eeeeeeees wait(2) 
terminfo compiler tic oes tic(1m) 
terminfo database tput .....0.00. ee tput(1) 
TOO: Les scatenniarhanendestcentnmiedenssuneemeeass terminfo(4) 
termlib terminal independent ................. termlib(3c) 
test condition evaluation ............. test(1) 
test your knowledge quiz ........0. quiz(6) 
TOS Lh cog nated adams test(1) 
TEXT EGilOMC! ccciacvecniuneccecuns ed(1) 
TEXt-GOilOr OX: idk twa eaten ex(1) 
text editor variant of ex for oo... ee edit(1) 
text fiIl@ NEWFOFMN ooo. ccccecesstteeeeeeees newform(1) 
text fIIES FSPEC oo... eee ccenecetereteneeeeees fspec(4) 
text for nroff or troff 0.0... ee eeeeeeees eqn(1) 
TEXT TOF ON OT eiisaitresvess oo eeseorrceasietntvaete ne ocw(1) 
text formatting and typesetting ............... troff(1) 
NOMA fi ccarsecactetwassatnhentcee dreds ude nash laana Geutedeasacitaen nroff(1) 
TEX ia Aine eae Meio sroff(1) 
text, or data in memory plock ................. plock(2) 
the C lanquage preprocessor cpp .......... cpp(1) 
the game of backgammon back ............ back(6) 
the game of black jack bj .......... ee bj(6) 
the game of CrapS CrapS ou. ee craps(6) 
the game of hunt-the-wumpus. ............... wump(6) 
the null file Mull oo... ee eeeeeereceeeeees null(7) 
NG sedexecconsst essguatoaeaeinen Wadena areas tic(1m) 
time a command time .......... eee time(1) 
time a command; report process. ........... timex(1) 
times of a file TOUCH... eee touch(1) 
MMOS UUMG. orientate ence eased: utime(2) 
NINOS asassuicieccirnanbeseagenctenaenneae: times(2) 
timex time a command; report ............... timex(1) 
HN OTH eas een tneictecan tsb ietaeeeast ate rennaeeeaete tmpfile(3S) 
TNPNAM ChOAlO- setcicieteredimanniuvnian tmpnam(3S) 
to/from a ProCe€SS POPeN ...... ees popen(3S) 
TOC QLADNICAD ens asisisinnzapenessasierstacanawinsonseres toc(1) 
topological sort tSOrt 00... eeeees tsort(1) 
topq prioritize print qUeUe ...... eee. topq(1m) 
total accounting files acctmerg ............. acctmerg(1m) 
touch update ACCESS ....... ee touch(1) 
TDIOR seceeapae soiree aaahsueeeeteac tes eee tplot(1) 
TOUC SG onen idea eetrer ei ear raiees tput(1) 
UI atest dant ats Seanad aatsacaeinasnas cuomunaaa set aiee das tr(1) 
WACE PACE cisssasssssiisrissscsreranesanaiaesan ptrace(2) 
transfer-of-Sign iNtriNSiC ......... eee sign(3F) 
translate characters CONV ......... ee conv(3C) 
translate characters tr oo... eee tr(1) 
transport program for the uucp ............... uucico(1m) 
HOO TIW picnic ouch tata nset a uatelanee: ftw(3C) 
MEGS TSCANCIT sexe ssscea wig vec cucstnaatseacns Sued? tsearch(3C) 
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trigonometric functions 
language 

9700 printer dx9700 prepare 
typesetting viewgraphs mv a 
tc 

simple pictures pic 
typesetting 

tbl format tables for nroff or 
mathematical text for nroff or 
files for device-independent 
provide truth values 

provide 

manage binary search trees 
topological sort 


get the name of the terminal 
controlling terminal interface 
find name of a terminal 

the utmp file of the current user 
types by port 

explicit Fortran 
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intro — introduction to system calls and error numbers 


SYNOPSIS 


#include <errno.h> 


DESCRIPTION 
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This section describes all of the system calls. The sub-section, 
Section 2S, describes the system calls and functions provided in the 
standalone archive /lib/lib2.a. 


Most of the calls in this section have one or more error returns. An 
error condition is indicated by an otherwise impossible returned 
value. This is usually —1; the individual descriptions specify the 
details. An error number is also made available in the external vari- 
able errno. Errno is not cleared on successful calls, so it should be 
tested only after an error has been indicated. 


Each system call description attempts to list all possible error 
numbers. The following is a complete list of the error numbers and 
their names as defined in <errno.h>. 


1 EPERM Not owner 
Usually this error indicates an attempt to modify a file in 
some way that is reserved for its owner or super-user, or 
when an ordinary user attempts to do things allowed only by 
the super-user. 


2 ENOENT No such file or directory 
This error occurs when a file name or directory (in a path 
name) is specified and should exist but does not. 


3 ESRCH No such process 
No process can be found corresponding to that specified by 
pid in kill or ptrace. 


4 EINTR Interrupted system call 
An asynchronous signal (such as interrupt or quit), which 
the user has elected to catch, occurred during a system call. 
lf execution is resumed after processing the signal, it will 
appear as if the interrupted system call returned this error 
condition. 


5 ElO I/O error 
Some physical I/O error has occurred. In some cases this 
error may occur on a Call following the one to which it actu- 
ally applies. 


6 ENXIO No such device or address 
I/O on a special file refers to a subdevice which does not 
exist, or beyond the limits of the device. It may also occur 
_when a tape drive is not on-line or no disk pack is loaded on 
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a drive. 


7 E2BIG Arg list too long ) 


An argument list longer than 5,120 bytes is presented to a — 
member of the exec family. 


8 ENOEXEC Exec format error 
A request is made to execute a file which does not start with 
a valid magic number although it may have the appropriate 
permissions, (see a.out(4)). 


9 EBADF Bad file number 
Either a file descriptor refers to no open file, or a read (or 
write) request is made to a file which is open only for writing 
(or reading). 


10 ECHILD No child processes 
A wait was executed by a process that had no existing or 
unwaited-for child processes. 


11 EAGAIN No more processes 
A fork failed because the system's process table is full or 
the user is not allowed to create any more processes. 


12 ENOMEM Not enough space 
During an exec, brk, or sbrk, a program asks for more - 
space than the system is able to supply. This is notatem- 
porary condition; the maximum space size is a system _ 
parameter. The error may also occur if the arrangement of 
text, data, and stack segments requires too many segmen- 
tation registers, or if there is not enough swap space during 
a fork. 


13 EACCES Permission denied 
An attempt was made to access a file in a way forbidden by 
the protection system. 


14 EFAULT Bad address 
The system encountered a hardware fault in attempting to 
use an argument of a system call. 


15 ENOTBLK Block device required | 
A non-block file was mentioned where a block device was 
required, e.g., in mount. 


16 EBUSY Device or resource busy | 
An attempt was made to mount a device that was already 
mounted or an attempt was made to dismount a device on 
which there is an active file (open file, current directory, ~ > 
mounted-on file, active text segment). It will also occur if an \ 
attempt is made to enable accounting when it is already 
enabled. The device or resource is currently unavailable. 
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17 EEXIST File exists 
An existing file was mentioned in an inappropriate context, 
e.g., link. 


18 EXDEV Cross-device link 
A link to a file on another device was attempted. 


19 ENODEV No such device 
An attempt was made to apply an inappropriate system call 
to a device; e.g., read a write-only device. 


20 ENOTDIR Not a directory 
A non-directory was specified where a directory is required, 
for example in a path prefix or as an argument to chdir(2). 


21 EISDIR Is a directory 
An attempt was made to write on a directory. 


22 EINVAL Invalid argument 
Some invalid argument (e.g., dismounting a non-mounted 
device; mentioning an undefined signal in signal, or kill; 
reading or writing a file for which /seek has generated a 
negative pointer). Also set by the math functions described 
in the (8M) entries of this manual. 


fL > 23 ENFILE File table overflow 
= The system file table is full, and temporarily no more opens 
can be accepted. 


24 EMFILE Too many open files 
No process can have more than 20 file descriptors open at 
a time. 


25 ENOTTY Not a character device 
An attempt was made to /oct/(2) a file that is not a special 
character device. 


26 ETXTBSY Text file busy 
An attempt was made to execute a pure-procedure program 
that is currently open for writing. Also an attempt to open 
for writing a pure-procedure program that is being executed. 


27 EFBIG File too large 
The size of a file exceeded the maximum file size 
(1,082,201 ,088 bytes) or ULIMIT; see ulimit (2). 

28 ENOSPC No space left on device 
During a write to an ordinary file, there is no free space left 
on the device. 


( : 29 ESPIPE Illegal seek 
~~ An Iseek was issued to a pipe. 
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30 EROFS Read-only file system ; 
An attempt to modify a file or directory was made on a dev- © \ 
ice mounted read-only. aes 
31 EMLINK Too many links 
An attempt to make more than the maximum number of 
links (1000) to a file. 
32 EPIPE Broken pipe 
A write on a pipe for which there is no process to read the 
data. This condition normally generates a signal; the error 
is returned if the signal is ignored. 
33 EDOM Math argument 
The argument of a function in the math package (3M) is out 
of the domain of the function. 
34 ERANGE Result too large 
The value of a function in the math package (3M) is not 
representable within machine precision. 
34 EDEADLOCK Process could become deadlocked 
The process has a file locked by lockf or locking and tryed 
to access a file locked by another process. 
35 HDLCK No message of desired type a. 
35 ENOMSG No message of desired type a 
An attempt was made to receive a message of a type that 
does not exist on the specified message queue; see msgop 
(2). 
36 EIDRM Identifier Removed 
This error is returned to processes that resume execution 
due to the removal of an identifier from the file system's 
name space (see msgctl (2), semct! (2), and shmetl (2)). 


37 ECHRNG Channel number out of range 
38 EL2NSYNC Level 2 not synchronized 
39 ELSHLT Level 3 halted 

40 EL3RDT Level 3 reset 

41 ELNRNG Link number out of range 

42 EUNATCH Protocol driver out of range 
43 ENOCSI! No CSI structure available 

44 EL2HLT Level 2 halted 
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DEFINITIONS 


Process ID 
Each active process in the system is uniquely identified by a positive 
integer called a process ID. The range of this ID is from 1 to 30,000. 


Parent Process ID 
A new process is created by a currently active process; see fork (2). 
The parent process ID of a process is the process ID of its creator. 


Process Group ID 
Each active process is a member of a process group that is identi- 
fied by a positive integer called the process group ID. This ID is the 
process ID of the group leader. This grouping permits the signaling 
of related processes; see kill (2). 


Tty Group ID 
Each active process can be a member of a terminal group that is 
identified by a positive integer called the tty group ID. This grouping 
is used to terminate a group of related processes upon termination 
of one of the processes in the group; see exit (2) and signal (2). 


Real User ID and Real Group !D 
Each user allowed on the system is identified by a positive integer 
called a real user ID. 


Each user is also a member of a group. The group is identified by a 
positive integer called the real group ID. 


An active process has a real user ID and real group ID that are set 
to the real user ID and real group ID, respectively, of the user 
responsible for the creation of the process. 


Effective User ID and Effective Group ID 
An active process has an effective user ID and an effective group ID 
that are used to determine file access permissions (see below). The 
effective user ID and effective group ID are equal to the process's 
real user ID and real group ID respectively, unless the process or 
one of its ancestors evolved from a file that had the set-user-ID bit 
or set-group ID bit set; see exec (2). 


Super-user 
A process is recognized as a Super-user process and is granted 
special privileges if its effective user ID is 0. 


Special Processes 
The processes with a process ID of 0 and a process ID of 1 are spe- 
cial processes and are referred to as procO and proci. 


ProcO is the scheduler. Proc is the initialization process ( init ). 
Proc1 is the ancestor of every other process in the system and is 
used to control the process structure. 
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File Descriptor : 
A file descriptor is a small integer used to do VO ona file. The value, > 
of a file descriptor is from 0 to 19. A process may have no more ~. ” 
than 20 file descriptors (0-19) open simultaneously. A file descriptor 
is returned by system calls such as open(2), or pipe(2). The file 
descriptor is used as an argument by calls such as read(2), write(2), 
ioctl(2), and close(2). 


File Name 
Names consisting of 1 to 14 characters may be used to name an 
ordinary file, special file or directory. 7 


These characters may be selected from the set of all character 
values excluding \O (null) and the ASCII code for / (slash). 


Note that it is generally unwise to use * , ? , [, or ] as part of file 
names because of the special meaning attached to these characters 
by the shell. See sh (7). Although permitted, it is advisable to avoid 
the use of unprintable characters in file names. 


Path Name and Path Prefix 
A path name is a null-terminated character string starting with an 
optional slash (/), followed by zero or more directory names 
separated by slashes, optionally followed by a file name. 


More precisely, a path name is a null- terminated character string ‘ 
constructed as follows: 


<path-name>::=<file-name> |<path-prefix> <file- nance 
<path-prefix> ::= <rtprefix> |/<rtprefix> 
<rtprefix>::=<dirname>/|<rtprefix><dirname>/ 


where <file-name> is a string of 1 to 14 characters other than the 
ASCII slash and null, and <dirname> is a string of 1 to 14 charac- 
ters (other than the ASCII slash and null) that names a directory. 


lf a path name begins with a slash, the path search begins at the 
root directory. Otherwise, the search begins from the current work- 
ing directory. 


A slash by itself names the root directory. 


Unless specifically stated otherwise, the null path name is asied as 
if it named a non-existent file. 


Directory 
Directory entries are called links. By convention, a ‘directory con- 
tains at least two links, . and .. , referred to as dot and dof-dot 
respectively. Dot refers to the directory itself and dot-dot refers to _ " 
its parent directory. 
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Root Directory and Current Working Directory 
( \ Each process has associated with it a concept of a root directory 
LY and a current working directory for the purpose of resolving path 
name searches. The root directory of a process need not be the 


root directory of the root file system. 


File Access Permissions | 
Read, write, and execute/search permissions on a file are granted to 
a process if one or more of the following are true: 


The effective user ID of the process is Super-user. 


The effective user ID of the process matches the user ID of 
the owner of the file and the appropriate access bit of the 
“owner” portion (0700) of the file mode Is set. 


The effective user ID of the process does not match the 
user ID of the owner of the file, and the effective group ID of 
the process matches the group of the file and the appropri- 
ate access bit of the “group” portion (070) of the file mode 
is set. 
The effective user ID of the process does not match the 
user ID of the owner of the file, and the effective group ID of 
ae the process does not match the group ID of the file, and the 
( ; appropriate access bit of the “other” portion (07) of the file 
~~ mode is set. 
Otherwise, the corresponding permissions are denied. 
Message Queue Identifier 
A message queue identifier (msqid) is a unique positive integer 
created by a msgget (2) system call. Each msqid has a message 


queue and a data structure associated with it. The data structure is 
referred to as msqgid_ds and contains the following members: 


struct ipc_perm msg_perm; /* operation permission struct */ 


ushort msg_qnum; /* number of msgs on q */ 
ushort msg_qbytes; /* max number of bytes on q */ 
ushort msg_lIspid; /* pid of last msgsnd operation */ 
ushort msg_Irpid; /* pid of last msgrcv operation */ 
time_t msg_stime; /* last msgsnd time */ 

time_t msg_rtime; /* last msgrcv time */ 

time_t msg_ctime; /* last change time «/ 


/« Times measured in secs since */ 
/* 00:00:00 GMT, Jan. 1, 1970 «*/ 
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Msg_perm is an ipc_perm structure that specifies the message 


operation permission (see below). This structure includes the fol-- 


lowing members: 


ushort cuid; /* creator user id */ 
ushort cgid; /* creator group id */ 
ushort — uid; /* user id */ 

ushort gid; /* group id */ 

ushort mode; /* r/w permission */ 


Msg_qnum is the number of messages currently on the queue. 
Msg_qbytes is the maximum number of bytes allowed on the 
queue. Msg_Ispid is the process id of the last process that per- 
formed a msgsnd operation. Msg_Iirpid is the process id of the last 
process that performed a msgrcv operation. Msg_stime is the time 
of the last msgsnd operation, msg_rtime is the time of the last 
msgrcv operation, and msg_ctime is the time of the last msgct/ (2) 
operation that changed a member of the above structure. 


Message Operation Permissions 
In the msgop (2) and msgctl (2) system call descriptions, the per- 
mission required for an operation is given as "{token}", where 
"token" is the type of permission needed interpreted as follows: 


00400 Read by user 
00200 Write by user 
00060 Read, Write by group 
00006 Read, Write by others 


Read and Write permissions on a msqid are granted to a process if 
one or more of the following are true: 


The effective user ID of the process is super-user. 


The effective user ID of the process matches 
msg_perm.[cjuid in the data structure associated with 
msgid and the appropriate bit of the “user” portion (0600) of 
msg_perm.mode is set. 


The effective user ID of the process does not match 
msg_perm.[c]uid and the effective group ID of the process 
matches msg_perm.[c]gid and the appropriate bit of the 
“group” portion (060) of msg_perm.mode is set. 


The effective user ID of the process does not match 
msg_perm.[cluid and the effective group ID of the process 


does not match msg_perm.[c]gid and the appropriate bit of | 


the “other” portion (06) of msg_perm.mode is set. 
Otherwise, the corresponding permissions are denied. 
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Semaphore Identifier 
ale. A semaphore identifier (semid) is a unique positive integer created 
( wf by a semget (2) system call. Each semid has a set of semaphores 
and a data structure associated with it. The data structure is 
referred to as semid_ds and contains the following members: 


struct ipc_perm sem_perm; /* operation permission struct */ 


ushort sem_nsems; /* number of sems in set */ 
time_t sem_otime; /* last operation time *«/ 
time_t sem_ctime; /* last change time «/ 


/*« Times measured in secs since */ 
/* 00:00:00 GMT, Jan. 1, 1970 */ 


Sem_perm is an ipc_perm structure that specifies the semaphore 
operation permission (see below). This structure includes the fol- 
lowing members: 


ushort  cuid; /* creator user id */ 
ushort cgid; /* creator group id */ 
ushort — uid; /* user id */ 
ushort gid; /* group id */ 
ushort mode; /* rla permission «/ 
The value of sem_nsems is equal to the number of semaphores in 
-— the set. Each semaphore in the set is referenced by a positive 
(_ integer referred to as a sem_num . Sem_num values run sequen- 


tially from O to the value of sem_nsems minus 1. Sem_otime is the 
time of the last semop (2) operation, and sem_ctime is the time of 
the last semctl (2) operation that changed a member of the above 


structure. 
A semaphore is a data structure that contains the following 
members: : 

ushort semval; /* semaphore value */ 

short sempid; /* pid of last operation */ 


ushort semncnt; /* # awaiting semval > cval */ 
ushort semzcnt; /* # awaiting semval = O */ 


Semval is a non-negative integer. Sempid is equal to the process 
ID of the last process that performed a semaphore operation on this 
semaphore. Semnent is a count of the number of processes that 
are currently suspended awaiting this semaphore's semval to 
become greater than its current value. Semzcnt is a count of the 
number of processes that are currently suspended awaiting this 
semaphore’s semval to become zero. 
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Semaphore Operation Permissions 
In the semop (2) and semctl (2) system call descriptions, the per- ~ 
mission required for an operation is given as "{token}", where Si 
"token" is the type of permission needed interpreted as follows: 


00400 Read by user 
00200 Alter by user 
00060 Read, Alter by group 
00006 Read, Alter by others 


Read and Alter permissions on a semid are granted to a process if 
one or more of the following are true: 


The effective user ID of the process is super-user. 


The effective user ID of the process matches 
sem_perm.[cluid in the data structure associated with 
semid and the appropriate bit of the “user” portion (0600) of 
sem_perm.mode is set. 


The effective user ID of the process does not match 
sem_perm.[c]uid and the effective group ID of the process 
matches sem_perm.[c]gid and the appropriate bit of the 
“group” portion (060) of sem_perm.mode is set. 


The effective user ID of the process does not match ~~ 
sem_perm.[c]Juid and the effective group ID of the process _ ss, 
does not match sem_perm.[c]gid and the appropriate bit of 
the “other” portion (06) of sem_perm.mode is set. 


Otherwise, the corresponding permissions are denied. 


Shared Memory Identifier 
A shared memory identifier (shmid) is a unique positive integer 
created by a shmget (2) system call. Each shmid has a segment of 
memory (shared memory segment) and a data structure 
(schmid_ds) associated with it which contains the following 


members: 
struct ipc_perm shm_perm; /* operation permission struct «/ 
int shm_segsz; /* size of segment */ 
ushort shm_cpid; /* creator pid «/ 
ushort shm_lpid; /* pid of last operation */ 
short shm_nattch; /* number of current attaches */ 
time_t shm_atime; /* last attach time #/ 
time_t shm_dtime; /* last detach time */ 
time_t shm_ctime; /* last change time */ 


/* Times measured in secs since */ 
/* 00:00:00 GMT, Jan. 1,197C > 
Ne i 
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Shm_perm is an ipc_perm structure that specifies the shared 
memory operation permission (below) and includes the following: 


ushort cuid; /* creator user id */ 
ushort cagid; /* creator group id */ 
ushort — uid; /* user id */ 

ushort gid; /* group id */ 

ushort mode; /* r/w permission */ 


Shm_segsz specifies the size of the shared memory segment. 
Shm_cpid is the process id of the process that created the shared 
memory identifier. Shm_Ipid is the process id of the last process 
that performed a shmop (2) operation. Shm_nattch is the number 
of processes that currently have this segment attached. 
Shm_atime is the time of the last shmat operation, shm_dtime is 
the time of the last shmadt operation, and shm_ctime is the time of 
the last shmct/ (2) operation that changed one of the members of 
the above structure. 


Shared Memory Operation Permissions 


In the shmop (2) and shmctl (2) system call descriptions, the per- 
mission required for an operation is given as "{token}", where 
"token" is the type of permission needed interpreted as follows: 


00400 Read by user 
00200 Write by user 
00060 Read, Write by group 
00006 Read, Write by others 


Read and Write permissions on a shmid are granted to a process if 
one or more of the following are true: 


The effective user ID of the process is super-user. 


The effective user ID of the process matches 
shm_perm.[c]uid in the data structure associated with 
shmid and the appropriate bit of the “user” portion (0600) of 
shm_perm.mode is set. 


The effective user ID of the process does not match 
shm_perm.[c]uid and the effective group ID of the process 
matches shm_perm.[c]gid and the appropriate bit of the 
“group” portion (060) of shm_perm.mode is set. 


The effective user ID of the process does not match 
shm_perm.[c]luid and the effective group ID of the process 
does not match shm_perm.[c]gid and the appropriate bit of 
the “other” portion (06) of shm_perm.mode is set. 


Otherwise, the corresponding permissions are denied. 


SEE ALSO 


close(2), ioctl(2), open(2), pipe(2), read(2), write(2), intro(3). 
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NAME 
access — determine accessibility of a file 
SYNOPSIS 
int access (path, amode) 
char «path; 
int amode; 
DESCRIPTION 
Path points to a path name naming a file. Access checks the 
named file for accessibility according to the bit pattern contained in 
amode , using the real user ID in place of the effective user ID and 
the real group ID in place of the effective group ID. The bit pattern 
contained in amode is constructed as follows: 
04 read 
02 write 
01 execute (search) 
00 check existence of file | 
Access to the file is denied if one or more of the following are true: 
[ENOTDIR] A component of the path prefix is not a directory. 
[ENOENT] Read, write, or execute (search) permission is 
7 | requested for a null path name. 
( [ENOENT] The named file does not exist. 
4 [EACCES] Search permission is denied on a component of the 
path prefix. | 
[EROFS] Write access is requested for a file on a read-only 
file system. 


[ETXTBSY] Write access is requested for a pure procedure 
(shared text) file that is being executed. 

[EACCESS] Permission bits of the file mode do not permit 
the requested access. 

[EFAULT] Path points outside the allocated address 
space for the process. 


The owner of a file has permission checked with respect to the 
“owner” read, write, and execute mode bits Members of the file’s 
group other than the owner have permissions checked with respect 
to the “group” mode bits, and all others have permissions checked 
with respect to the “other” mode bits. | 


RETURN VALUE 
If the requested access is permitted, a value of 0 is returned. Oth- 
erwise, a value of —1 is returned and errno is set to indicate the 
error. 


SEE ALSO 
chmod(2), stat(2). 
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NAME 


acct — enable or disable process accounting 


SYNOPSIS 
_ int acct (path) 


char *path; 


DESCRIPTION 


Acct is used to enable or disable the system process accounting 


routine. If the routine is enabled, an accounting record will be writ- 


ten on an accounting file for each process that terminates. Termi- 
nation can be caused by one of two things: an exit call or a signal; 
see exit (2) and signal (2). The effective user ID of the calling pro- 
cess must be super-user to use this call. 


Path points to a path name naming the accounting file. The 


~ accounting file format is given in acct (4). 


The accounting routine is enabled if path is non-zero and no errors 
occur during the system call. It is disabled if path is zero and no 


errors occur during the system call. 
Acct will fail if one or more of the following are true: 


[EPERM] ___ The effective user of the calling process is not 
| 3 super-user. 
_(EBUSY] _ An attempt is being made to enable accounting 
| mg when it is already enabled. 
[ENOTDIR] A component of the path prefix is not a directory. 
fENOENT] | One or more components of the accounting file 
| path name do not exist. _ 
[EACCES] ~ A component of the path prefix denies search per- 
a mission. _ 
 [EACCES] “The file named by path is not an ordinary file. 
[EACCES} = Mode permission is denied for the named account- 
. ing file. 
[EISDIR} The named file is a directory. 
_ {EROFS] The named file resides on a read-only file system. 
[EFAULT] Path points to an illegal address. 


RETURN VALUE 


_ Upon successful completion, a value of 0 is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the error. 


SEE ALSO 
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— exit(2), signal(2), acct(4). 
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_ NAME 
a alarm — set a process alarm clock 


” SYNOPSIS 
unsigned alarm (sec) 
unsigned sec; 


DESCRIPTION 
Alarm instructs the alarm clock of the calling process to send the 
signal SIGALRM to the calling process after the number of real time 
seconds specified by sec have elapsed; see signal (2). 


Alarm requests are not stacked; successive calls reset the alarm 
clock of the calling process. 


If sec is 0, any previously made alarm request is canceled. 


RETURN VALUE 
Alarm returns the amount of time previously remaining in the alarm 
clock of the calling process. 


SEE ALSO | 
pause(2), signal(2). 
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NAME 
brk, sork — change data segment space allocation 


SYNOPSIS 
int brk (endds) 
char *endds; 


char *sbrk (incr) 
int incr; 

DESCRIPTION 
Brk and sbrk are used to change dynamically the amount of space 
allocated for the calling process’s data segment; see exec (2). The 
change is made by resetting the process's break value and allocat- 
ing the appropriate amount of space. The break value is the 
address of the first location beyond the end of the data segment. 
The amount of allocated space increases as the break value 
increases. The newly allocated space is set to zero. 


Brk sets the break value to endds and changes the allocated space 
accordingly. 


Sbrk adds incr bytes to the break value and changes the allocated 
space accordingly. Incr can be negative, in which case the amount 
of allocated space is decreased. 


Brk and sbrk will fail without making any change in the allocated _ 
space if one or more of the following are true: 


Such a change would result in more space being allocated 
than is allowed by a system-imposed maximum (see ulimit 
(2)). [ENOMEM] 


Such a change would result in the break value being greater 
than or equal to the start address of any attached shared 
memory segment (see shmop (2)). 


RETURN VALUE 
Upon successful completion, brk returns a value of 0 and sodrk 
returns the old break value. Otherwise, a value of —1 is returned 
and errno is set to indicate the error. 


SEE ALSO 
exec(2), shmop(2), ulimit(2). 
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~ NAME 
( ; chdir — change working directory 


SYNOPSIS 
int chdir (path) 
char «path; 


DESCRIPTION 
Path points to the path name of a directory. Chdir causes the 
named directory to become the current working directory, the start- 
ing point for path searches for path names not beginning with / . 


Chair will fail and the current working directory will be unchanged if 
one or more of the following are true: 


[ENOTDIR] A component of the path name is not a directory. 

[ENOENT] The named directory does not exist. 

[EACCES] Search permission is denied for any component of 
the path name. 

[EFAULT] - Path points outside the allocated address space of 


the process. 


_ RETURN VALUE 
| Upon successful completion, a value of 0 is returned. Otherwise, a 
mee value of —1 is returned and errno is set to indicate the error. 


SEE ALSO 
chroot(2). 
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NAME ee 
chmod — change mode of file | i 


SYNOPSIS 
int chmod (path, mode) 
char «path; 
int mode; 


DESCRIPTION 
Path points to a path name naming a file. Chmod sets the access 
permission portion of the named file's mode according to the bit pat- 
tern contained in mode . 


Access permission bits are interpreted as follows: 


04000 Set user ID on execution. 

02000 Set group ID on execution. 

0100G Save text image after execution. 

00400 Read by owner. 

00200 Write by owner. 

00100 Execute (search if a directory) by owner. 
00070 Read, write, execute (search) by group. 
00007 +#Read, write, execute (search) by others. 


The effective user ID of the process must match the owner of the file! | 
or be super-user to change the mode of a file. al 


lf the effective user ID of the process is not Ssuper-user, mode bit 
01000 (save text image on execution) is cleared. 


If the effective user ID of the process is not super-user and the 
effective group ID of the process does not match the group ID of the 
file, mode bit 02000 (set group ID on execution) is cleared. 


lf an executable file is prepared for sharing then mode bit 01000 
prevents the system from abandoning the swap-space image of the 
program-text portion of the file when its last user terminates. Thus, 
when the next user of the file executes it, the text need not be read 
from the file system but can simply be swapped in, saving time. 


Chmod will fail and the file mode will be unchanged if one or more 
of the following are true: 


[ENOTDIR}] A component of the path prefix is not a directory. 
[ENOENT] The named file does not exist. 


[EACCES] Search permission is denied on a component of the 
path prefix. jo 


[EPERM] The effective user ID does not match the owner of /” 
the file and the effective user ID is not super-user. 
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[EROFS] The named file resides on a read-only file system. 


( y [EFAULT] Path points outside the allocated address space of 
- the process. 


RETURN VALUE 
Upon successful completion, a value of O Is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the error. 


SEE ALSO | 
chown(2), mknod(2). 
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NAME ; _— 


, *s 
chown — change owner and group of a file | i J 
SYNOPSIS | 
int chown (path, owner, group) 
char «path; 
int owner, group; 
DESCRIPTION | 
Path points to a path name naming a file. The owner ID and group 
ID of the named file are set to the numeric values contained in 
owner and group respectively. 
Only processes with effective user ID equal to the file owner or 
super-user may change the ownership of a file. 
If chown is invoked by other than the super-user, the set-user-ID 
and set-group-ID bits of the file mode, 04000 and 02000 respec- 
tively, will be cleared. 
Chown will fail and the owner and group of the named file will 
remain unchanged if one or more of the following are true: 
[ENOTDIR] A component of the path prefix is not a directory. 
[ENOENT] The named file does not exist. yrs 
[EACCES] Search permission is denied on a component of the \ 
| path prefix. 
[EPERM] The effective user ID does not match the owner of 
the file and the effective user ID is not super-user. 
[EROFS] The named file resides on a read-only file system. 
[EFAULT] ~~ —“~ Path points outside the allocated address space of 
the process. 
RETURN VALUE 
Upon successful completion, a value of 0 is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the error. 
SEE ALSO 
chmod(2). 
chown(1) in the Sys5 UNIX User Reference Manual. 
_— 
Se 
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--.. NAME 


} 


chroot — change root directory 


~~" SYNOPSIS 


int chroot (path) 
char *path; 


DESCRIPTION 


xy 

| + 

b 

a. 
—_— 


Path points to a path name naming a directory. Chroot causes the 
named directory to become the root directory, the starting point for 
path searches for path names beginning with / . The user's working 
directory is unaffected by the chroot system call. 


The effective user ID of the process must be super-user to change 
the root directory. 


The .. entry in the root directory is interpreted to mean the root 
directory itself. Thus, .. cannot be used to access files outside the 
subtree rooted at the root directory. 


Chroot will fail and the root directory will remain unchanged if one or 
more of the following are true: 


[ENOTDIR] Any component of the path name is not a directory. 
[ENOENT] The named directory does not exist. 

[EPERM] The effective user ID is not super-user. 

[EFAULT] Path points outside the allocated address space of 


the process. 


RETURN VALUE 


Upon successful completion, a value of 0 is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the error. 


SEE ALSO 
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chdir(2). 
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NAME : eee 
— 
close — close a file descriptor a, 
SYNOPSIS _ 
int close (fildes) 
int fildes; 
DESCRIPTION 
Fildes is a file descriptor obtained from a creat , open, dup, fenti, 
Or pipe system call. Close closes the file descriptor indicated by 
fildes . 
Close will fail if fildes is not a valid open file descriptor. 
RETURN VALUE 
Upon successful completion, a value of 0 is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the error. 
SEE ALSO | 
creat(2), dup(2), exec(2), fentl(2), open(2), pipe(2). 
—— 
Se ae 
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NAME 


creat — create a new file or rewrite an existing one 


— SYNOPSIS 


int creat (path, mode) 
char *path; 
int mode; 


DESCRIPTION 


Page 1 


Creat creates a new ordinary file or prepares to rewrite an existing 
file named by the path name pointed to by path . 


If the file exists, the length is truncated to 0 and the mode and 
owner are unchanged. Otherwise, the file's owner ID is set to the 
effective user ID, of the process the group ID of the process is set to 
the effective group ID, of the process and the low-order 12 bits of 
the file mode are set to the value of mode modified as follows: 


All bits set in the process's file mode creation mask are 
cleared. See umask (2). 


The “save text image after execution bit” of the mode is 
cleared. See chmod (2). 


Upon successful completion, the file descriptor is returned and the 
file is open for writing, even if the mode does not permit writing. 
The file pointer is set to the beginning of the file. The file descriptor 
is set to remain open across exec system calls. See fcntl (2). No 
process may have more than 20 files open simultaneously. A new 
file may be created with a mode that forbids writing. 


Creat will fail if one or more of the following are true: 


[ENOTDIR] A component of the path prefix is not a directory. 

[ENOENT] A component of the path prefix does not exist. 

[EACCES] Search permission is denied on a component of the 
path prefix. 

[ENOENT] The path name is null. 

[EACCES] The file does not exist and the directory in which 
the file is to be created does not permit writing. 

[EROFS] The named file resides or would reside on a read- 
only file system. 

[ETXTBSY] The file is a pure procedure (shared text) file that is 
being executed. 

[EACCES] The file exists and write permission is denied. 

[EISDIR] The named file is an existing directory. 

fEMFILE] Twenty (20) file descriptors are currently open. 
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[EFAULT] Path points outside the allocated address space of are 
the process. : \ 

Ras ait 

[ENFILE} The system file table is full. ne 


RETURN VALUE 
Upon successful completion, a non-negative integer, namely the file 
descriptor, is returned. Otherwise, a value of —1 is returned and 
errno is set to indicate the error. 


SEE ALSO 
chmod(2), close(2), dup(2), fentl(2), Iseek(2), open(2), read(2), 
umask(2), write(2). 


§ 
; 
ot 
Seco 2 253 
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NAME 
dup — duplicate an open file descriptor 


SYNOPSIS 
int dup (fildes) 
int fildes; 


DESCRIPTION 
Fildes is a file descriptor obtained from a creat, open, dup, fentl, 
or pipe system call. Dup returns a new file descriptor having the 
following in common with the original: 


Same open file (or pipe). 


Same file pointer (i.e., both file descriptors share one file 
pointer). 


Same access mode (read, write or read/write). 


The new file descriptor is set to remain open across exec system 
calls. See fent/l (2). 


The file descriptor returned is the lowest one available. 
Dup will fail if one or more of the following are true: 
[EBADF] Fildes is not a valid open file descriptor. 
( [EMFILE] Twenty (20) file descriptors are currently open. 


RETURN VALUE 
Upon successful completion a non-negative integer, namely the file 
descriptor, is returned. Otherwise, a value of —1 is returned and 
errno is set to indicate the error. 


SEE ALSO 
creat(2), close(2), exec(2), fentl(2), open(2), pipe(2). 
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NAME 


execi, execv, execle, execve, execip, execvp — execute a file “a 


SYNOPSIS ct 


int exec! (path, argO, arg1, ..., argn, Q) 

char *path, *argO, *arg1, ..., *argn; 

int execv (path, argv) 

char *path, *«argv[ ]; 

int execle (path, argO, arg1, ..., argn, 0, envp) 
char *path, *arg0, *arg1, ..., «argn, *envp[ J; 
int execve (path, argv, envp) 

char *path, *argv[ ], *envp[ ]; 

int execip (file, argQ, arg1, ..., argn, 0) 

char +file, *arg0, *arg1, ..., *argn; 

int execvp (file, argv) 

char +file, *argv[ ]; 


DESCRIPTION 
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Exec in all its forms transforms the calling process into a new pro- 

cess. The new process is constructed from an ordinary, executable 

file called the new process file . This file consists of a header (see 

a.out (4)), a text segment, and a data segment. The datasegment ~ 
contains an initialized portion and an uninitialized portion (bss). . / 
There can be no return from a successful exec because the calling 
process is overlaid by the new process. 


When a C program is executed, it is called as follows: 


main (argc, argv, envp) 
int argc; | 
char **argv, **envp; 


where argc is the argument count and argv is an array of character 
pointers to the arguments themselves. As indicated, argc is con- 
ventionally at least one and the first member of the array points to a 
string containing the name of the file. 


Path points to a path name that identifies the new process file. 


File points to the new process file. The path prefix for this file is 
obtained by a search of the directories passed as the environment 
line "PATH =" (see environ (5)). The environment is supplied by the 
shell (see sh (7)). 


ArgO , arg? , ... , argn are pointers to null-terminated character 
strings. These strings constitute the argument list available to the oN 
new process. By convention, at least argO must be present and \_ - 
point to a string that is the same as path (or its last component). ° 
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Argv is an array of character pointers to null-terminated strings. 
These strings constitute the argument list available to the new pro- 
cess. By convention, argv must have at least one member, and it 
must point to a string that is the same as path (or its last com- 
ponent). Argv is terminated by a null pointer. 


Envp is an array of character pointers to null-terminated strings. 
These strings constitute the environment for the new process. Envp 
is terminated by a null pointer. For exec/ and execv , the C run- 
time start-off routine places a pointer to the environment of the cal- 
ling process in the global cell: 
extern char **environ; 

and it is used to pass the environment of the calling process to the 
new process. 


File descriptors open in the calling process remain open in the new 
process, except for those whose close-on-exec flag is set; see fcnt/ 
(2). For those file descriptors that remain open, the file pointer is 
unchanged. 


Signals set to terminate the calling process will be set to terminate 
the new process. Signals set to be ignored by the calling process 


— will be set to be ignored by the new process. Signals set to be 


caught by the calling process will be set to terminate new process; 
see signal (2). 7 


If the set-user-ID mode bit of the new process file is set (see chmod 
(2)), exec sets the effective user ID of the new process to the 
owner ID of the new process file. Similarly, if the set-group-ID mode 
bit of the new process file is set, the effective group ID of the new 
process is set to the group ID of the new process file. The real user 
ID and real group ID of the new process remain the same as those 
of the calling process. | _ 


The shared memory segments attached to the calling process will 
not be attached to the new process (see shmop (2)). 


Profiling is disabled for the new process; see profil (2). 


The new process also inherits the following attributes from the cal- 


ling process: 


nice value (see nice (2)) 

process ID 

parent process ID 

process group ID 

semadj values (see semop (2)) 

tty group ID (see exit (2) and signal (2)) 

trace flag (see ptrace (2) request 0) 

time left until an alarm clock signal (see a/arm (2)) 
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current working directory 


root directory 3 


file mode creation mask (see umask (2)) ee 
file size limit (see ulimit (2)) 
utime , stime , cutime , and cstime (see times (2)) 


Exec will fail and return to the calling process if one or more of the 
following are true: . 


One or more components of the new process path 


[ENOENT] 
name of the file do not exist. 
[ENOTDIR] A component of the new process path of the file 
prefix is not a directory. 
[EACCES] Search permission is denied for a directory listed in 
the new process file's path prefix. 
[EACCES] The new process file is not an ordinary file. 
[EACCES] The new process file mode denies execution per- 
mission. 
[ENOEXEC] The exec is not an execip or execvp , and the 
new process file has the appropriate access per- 
mission but an invalid magic number in its header. an 
(ETXTBSY] The new process file is a pure procedure (shared\_ yy 
text) file that is currently open for writing by some — 
process. 
[ENOMEM] The new process requires more memory than is 
allowed by the system-imposed maximum MAX- 
MEM. 
[E2BIG] The number of bytes in the new process's argu- 
ment list is greater than the system-imposed limit 
of 5120 bytes. : 
[EFAULT] The new process file is not as long as indicated by 
the size values in its header. 
[EFAULT] | Path , argv , or envp point to an illegal address. 
RETURN VALUE 
If exec returns to the calling process an error has occurred; the 
return value will be —1 and errno will be set to indicate the error. 
SEE ALSO | | 
alarm(2), exit(2), fork(2), nice(2), ptrace(2), semop(2), signal(2), 
times(2), ulimit(2), umask(2), a.out(4), environ(5). aa 
sh(1) in the Sys5 UNIX User Reference Manual. re 
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exit, _exit — terminate process 


~ SYNOPSIS 


void exit (status) 
int status; 

void _exit (status) 
int status; 


DESCRIPTION 
Exit terminates the calling process with the following consequences: 


All of the file descriptors open in the calling process are 
closed. 


lf the parent process of the calling process is executing a 
wait , it is notified of the calling process's termination and 
the low order eight bits (i.e., bits 0377) of status are made 
available to it; see wait (2). 


If the parent process of the calling process is not executing 
a wait , the calling process is transformed into a zombie 
process. A zombie process 's a process that only occupies 
a slot in the process table. It has no other space allocated 
either in user or kernel space. The process table slot that it 
occupies is partially overlaid with time accounting informa- 
tion (see <sys/proc.h> ) to be used by times. 


The parent process ID of all of the calling process's existing 
child processes and zombie processes is set to 1. This 
means the initialization process (see intro (2)) inherits each 
of these processes. 


Each attached shared memory segment is detached and 
the value of shm_nattach in the data structure associated 
with its shared memory identifier is decremented by 1. 


For each semaphore for which the calling process has set a 
semadj value (see semop (2)), that semadj value is added 
to the semval of the specified semaphore. 


If the process has a process, text, or data lock, an un/ock is 
performed (see plock (2)). 


An accounting record is written on the accounting file if the 
system’s accounting routine is enabled; see acct (2). 


If the process ID, tty group ID, and process group ID of the 
calling process are equal, the SIGHUP signal is sent to each 
process that has a process group ID equal to that of the cal- 
ling process. 


The C function exit may cause cleanup actions before the process 
exits. The function _exit circumvents all cleanup. 
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SEE ALSO _ 
acct(2), intro(2), plock(2), semop(2), signal(2), wait(2). fo \ 
WARNING oe 


See WARNING in signal (2). 


—_—, 


. : j 
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_ NAME 


fentl — file control 


~ SYNOPSIS 


#include <fcntl.h> 


int fentl (fildes, cmd, arg) 
int fildes, cmd, arg; 


DESCRIPTION 
Fentl provides for control over open files. Fildes is an open file 
descriptor obtained from a creat , open, dup , fcntl , or pipe sys- 
tem call. 


The command s available are: 
F_DUPFD Return a new file descriptor as follows: 


Lowest numbered available file descriptor greater 
than or equal to arg . 


Same open file (or pipe) as the original file. 


same file pointer as the original file (i.e., both file 
descriptors share one file pointer). 


Same access mode (read, write or read/write). 


Same file status flags (i.e., both file descriptors 
share the same file status flags). 


The close-on-exec flag associated with the new file 
descriptor is set to remain open across exec (2) 
system calls. 


F_GETFD Get the close-on-exec flag associated with the file 
descriptor fildes . If the low-order bit is 0 the file will 
remain open across exec , otherwise the file will be 
closed upon execution of exec . 


F_SETFD Set the close-on-exec flag associated with fildes to 
the low-order bit of arg (0 or 1 as above). 

F_GETFL Get file status flags. 

F_SETFL Set file status flags to arg . Only certain flags can 


be set; see fcntl (5). 
Fent/ will fail if one or more of the following are true: 


[EBADF] Fildes is not a valid open file descriptor. 

[EMFILE] Cmd is F_DUPFD and 20 file descriptors are 
currently open. 

[EMFILE] Cmd is F_DUPFD and arg is negative or greater 
than 20. 


Page 1 May 7, 1986 


FCNTL(2) UNIX Sys5 FCNTL(2) 


RETURN VALUE we 
Upon successful completion, the value returned depends on cmd as» ‘\ 


follows: eae 
F_DUPFD A new file descriptor. 
F_GETFD Value of flag (only the low-order bit is 
defined). 
F_SETFD Value other than —1. 
F_GETFL Value of file flags. 
F_SETFL Value other than —1. 
Otherwise, a value of —1 is returned and errno is set to indicate the 
error. 
SEE ALSO 
close(2), exec(2), open(2), fentl(5). 
( " 
XS - es 
— 
y 


May 7, 1986 Page 2 


ect em 


FORK(2) 


NAME 


\ 


DESCRIPTION 
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( fork — create a new process 
SYNOPSIS | 


int fork () 


Fork causes creation of a new process. The new process (child 
process) is an exact copy of the calling process (parent process). 
This means the child process inherits the following attributes from 
the parent process: 


environment 

close-on-exec flag (see exec (2) ) 

signal handling settings (i.e., SIG_DFL , SIG_ING , function 
address) 

set-user-ID mode bit 

set-group-ID mode bit 

profiling on/off status 

nice value (see nice (2)) | 

all attached shared memory segments (see shmop (2)) 
process group ID i 
tty group ID (see exit (2) and signal (2)) 

trace flag (see ptrace (2) request 0) 

time left until an alarm clock signal (see alarm (2)) 
current working directory 

root directory 

file mode creation mask (see umask (2)) 

file size limit (see ulimit (2)) 


The child process differs from the parent process in the following 


ways: 


The child process has a unique process ID. 


The child process has a different parent process ID (i.e., the 
process ID of the parent process). 


The child process has its own copy of the parent's file 
descriptors. Each of the child's file descriptors shares a 
common file pointer with the corresponding file descriptor of 
the parent. 


All semadj values are cleared (see semop (2)). 


Process locks, text locks and data locks are not inherited by 
the child (see plock (2)). 
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The child process's utime , stime, cutime , and cstime are 


0. 


Fork will fail and no child process will be created if one or more of 
the following are true: 


[EAGAIN] The system-imposed limit on the total number of 
| processes under execution would be exceeded. 


[EAGAIN] The system-imposed limit on the total number of 
processes under execution by a single user would 
be exceeded. 


RETURN VALUE 
Upon successful completion, fork returns a value of O to the child 
process and returns the process ID of the child process to the 
parent process. Otherwise, a value of —1 is returned to the parent 
process, no child process is created, and errno is set to indicate the 
error. 


SEE ALSO 
exec(2), nice(2), plock(2), ptrace(2), semop(2), shmop(2), signai(2), 
times(2), ulimit(2), umask(2), wait(2). 
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_ NAME 
( ; getpid, getpgrp, getppid — get process, process group, and parent 
XY process IDs 

SYNOPSIS 


int getpid () 
int getpgrp () 
int getppid () 


DESCRIPTION 
Getpid returns the process ID of the calling process. 


Getpgrp returns the process group ID of the calling process. 
Getppid returns the parent process ID of the calling process. 


SEE ALSO 
exec(2), fork(2), intro(2), setpgrp(2), signal(2). 
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NAME. 
getuid, geteuid, getgid, getegid — get real user, effective user, real “> 
group, and effective group IDs 2 
SYNOPSIS : 


unsigned short getuid () 
unsigned short geteuid () 
unsigned short getgid () 
unsigned short getegid () 


DESCRIPTION : 
Getuid returns the real user ID of the calling process. 


Geteuid returns the effective user ID of the calling process. 
Getgid returns the real group ID of the calling process. 
Getegid returns the effective group ID of the calling process. 


SEE ALSO 
intro(2), setuid(2). 
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NAME 
( . ioctl — control device 


b 

SYNOPSIS 
ioctl (fildes, request, arg) 
int fildes, request; 


DESCRIPTION 
loct!l performs a variety of functions on character special files (dev- 
ices). The write-ups of various devices in Section 7 of the Sys5 
UNIX Administrator Reference Manual discuss how joct! applies to 
them. 


loct! will fail if one or more of the following are true: 


[EBADF] Fildes is not a valid open file descriptor. 

[ENOTTY] Fildes is not associated with a character special 
device. 

[EINVAL] Request or arg is not valid. See Section 7 of the 


Sys5 UNIX Administrator Reference Manual. 
[EINTR] | A signal was caught during the joct! system call. 


RETURN VALUE 
a If an error has occurred, a value of —1 is returned and errno is set to 
| indicate the error. 


SEE ALSO 
tty(7) in the Sys5 UNIX Administrator's Reference Manual. 
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a kill - send a signal to a process or a group of processes 
~~ SYNOPSIS 
int kill (pid, sig) 
int pid, sig; 
DESCRIPTION 


Kill sends a signal to a process or a group of processes. The pro- 
cess or group of processes to which the signal is to be sent is speci- 
fied by pid . The signal that is to be sent is specified by sig and is 
either one from the list given in signal (2), or O. If sig is O (the null 
signal), error checking is performed but no signal is actually sent. 
This can be used to check the validity of pid . 


The real or effective user ID of the sending process must match the 
real or effective user ID of the receiving process, unless the effective 
user ID of the sending process is Super-user. 


The processes with a process ID of 0 and a process ID of 1 are spe- 
cial processes (see intro (2)) and will be referred to below as procO 
and proc? , respectively. 


If pid is greater than zero, sig will be sent to the process whose 
process ID is equal to pid . Pid may equal 1. 


If pid is 0, sig will be sent to all processes excluding procO and 
proc? whose process group ID is equal to the process group ID of 
the sender. 


If pid is —1 and the effective user ID of the sender is not super-user, 
sig will be sent to all processes excluding procO and proc? whose 
real user ID is equal to the effective user ID of the sender. 


If pid is —1 and the effective user ID of the sender is super-user, sig 
will be sent to all processes excluding procO and proci. 


If pid is negative but not —1, sig will be sent to all processes whose 
process group ID is equal to the absolute value of pid. 


Kill will fail and no signal will be sent if one or more of the following 
are true: 


[EINVAL] Sig is not a valid signal number. 
[EINVAL] Sig is SIGKILL and pid is 1 (proc1). 
[ESRCH] No process can be found corresponding to that 


specified by pid . 
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[EPERM] The user ID of the sending process is not super- 
| user, and its real or effective user ID does not ) 
match the real or effective user ID of the receiving ~_” 
process. | 
RETURN VALUE 
Upon successful completion, a value of 0 is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the error. 
SEE ALSO 


getpid(2), setpgrp(2), signal(2). 
kill(1) in the Sys5 UNIX User Reference Manual. 
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| link — link to a file 
SYNOPSIS 


int link (path1, path2) 
char *path1, «path2; 


DESCRIPTION 


Path? points to a path name naming an existing file. Path2 points 
to a path name naming the new directory entry to be created. Link 
creates a new link (directory entry) for the existing file. 


Link will fatl and no link will be created if one or more of the follow- 


ing are true: 
[ENOTDIR] 
[ENOENT] 
[EACCES] 


[ENOENT] 
[EEXIST] 


= [EPERM] 


[EXDEV] 
[ENOENT] 
[EACCES] 
[EROFS] 
[EFAULT] 
[EMLINK] 


RETURN VALUE 


A component of either path prefix is not a directory. 
A component of either path prefix does not exist. 


A component of either path prefix denies search 
permission. 


The file named by path? does not exist. 
The link named by path2 exists. 


The file named by path? is a directory and the 
effective user ID is not super-user. 


The link named by path2 and the file named by 
path? are on different logical devices (file sys- 


tems). 


Path2 points to a null path name. 


The requested link requires writing in a directory 
with a mode that denies write permission. 


The requested link requires writing in a directory on 
a read-only file system. 


Path points outside the allocated address space of 
the process. — 


The maximum number of links to a file would be 
exceeded. 


Upon successful completion, a value of 0 is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the error. 


SEE ALSO 


\ unlink(2). 
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NAME gre 
lseek — move read/write file pointer : 


SYNOPSIS 
long Iseek (fildes, offset, whence) 
int fildes; 
long offset; 
int whence; 


DESCRIPTION 
Fildes is a file descriptor returned from a creat , open , dup , or 
fentl system call. Lseek sets the file pointer associated with fildes 
as follows: 


If whence is 0, the pointer is set to offset bytes. 


lf whence is 1, the pointer is set to its current location plus 
offset . 


lf whence is 2, the pointer is set to the size of the file plus 
offset . 


Upon successful completion, the resulting pointer location, as meas- 
ured in bytes from the beginning of the file, is returned. 


Lseek will fail and the file pointer will remain unchanged if one or ~~ 
more of the following are true: 


\ ; : y 
Se 7 


[EBADF] Fildes is not an open file descriptor. 
[ESPIPE] Fildes is associated with a pipe or fifo. 


[EINVAL and SIGSYS signal] 
Whence is not 0, 1, or 2. 


fEINVAL] — The resulting file pointer would be negative. 


Some devices are incapable of seeking. The value of the file 
pointer associated with such a device is undefined. 


RETURN VALUE 
Upon successful completion, a non-negative integer indicating the 
file pointer value is returned. Otherwise, a value of —1 is returned 
and errno is set to indicate the error. 


SEE ALSO 
creat(2), dup(2), fentl(2), open(2). 


gor 
Sow 
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NAME 


mknod — make a directory, or a special or ordinary file 


~ SYNOPSIS 


int mknod (path, mode, dev) 
char +path; 
int mode, dev; 


DESCRIPTION 


Page 1 


Mknod creates a new file named by the path name pointed to by 
path . The mode of the new file Is initialized from mode . Where the 
value of mode is interpreted as follows: 
0170000 file type; one of the following: 
0010000 fifo special 
0020000 character special 
0040000 directory 
0060000 block special 
0100000 or 0000000 ordinary file 
0004000 set user ID on execution 
0002000 set group ID on execution 
0001000 save text image after execution 
0000777 access permissions; constructed from the following 
0000400 read by owner 
0000200 write by owner 
0000100 execute (search on directory) by owner 
0000070 read, write, execute (search) by group 
0000007 read, write, execute (search) by others 


The owner ID of the file is set to the effective user ID of the process. 
The group ID of the file is set to the effective group ID of the pro- 
cess. 


Values of mode other than those above are undefined and should 
not be used. The low-order 9 bits of mode are modified by the 
process's file mode creation mask: all bits set in the process's file 
mode creation mask are cleared. See umask (2). If mode indicates 
a block or character special file, dev is a configuration-dependent 
specification of a character or block I/O device. If mode does not 
indicate a block special or character special device, dev is ignored. 


Mknod may be invoked only by the super-user for file types other 
than FIFO special. 


Mknod will fail and the new file will not be created if one or more of 
the following are true: 


[EPERM] The effective user ID of the process is not super- 
user. 
[ENOTDIR] A component of the path prefix is not a directory. 
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[ENOENT] A component of the path prefix does not exist. 
we 
[EROFS] The directory in which the file is to be created is . > 
located on a read-only file system. Se 
[EEXIST] The named file exists. 
[EFAULT] Path points outside the allocated address space of 
the process. 
RETURN VALUE 
Upon successful completion a value of O is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the error. 
SEE ALSO 
chmod(2), exec(2), umask(2), fs(4). 
mkdir(1) in the Sys5 UNIX User Reference Manual. 
- s 
Me 
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NAME 
mount — mount a file system 


SYNOPSIS 
int mount (spec, dir, rwflag) 
char *spec, +*dir; 
int rwflag; 


DESCRIPTION 
Mount requests that a removable file system contained on the block 
special file identified by spec be mounted on the directory identified 
by dir. Spec and dir are pointers to path names. 


Upon successful completion, references to the file dir will refer to 
the root directory on the mounted file system. 


The low-order bit of rwflag is used to control write permission on the 
mounted file system; if 1 , writing is forbidden, otherwise writing is 
permitted according to individual file accessibility. 


Mount may be invoked only by the super-user. 
Mount will fail if one or more of the following are true: 


[EPERM] The effective user ID is not super-user. 
a [ENOENT] Any of the named files does not exist. 
( ; [ENOTDIR] A component of a path prefix is not a directory. 
- [ENOTBLK] Spec is not a block special device. 
[ENXIO}] The device associated with spec does not exist. 
[ENOTDIR}] Dir is not a directory. 
[EFAULT] Spec or dir points outside the allocated address 
space of the process. | 
[EBUSY] Dir is currently mounted on, is someone's current 
working directory, or is otherwise busy. 
[EBUSY] The device associated with spec is currently 
| mounted. 
[EBUSY] There are no more mount table entries. 


RETURN VALUE 
Upon successful completion a value of O is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the error. 


SEE ALSO 
umount(2). 
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_. NAME 
: msgctl — message control operations 
~ SYNOPSIS 

#include <sys/types.h> 

#include <sys/ipc.h> 

#include <sys/msg.h> 

int msgctl (msqid, cmd, buf) 

int msqid, cmd; 

struct msqid_ds «buf; 

DESCRIPTION 

Msgctl provides a variety of message control operations as speci- 

fied by cmd . The following cmd s are available: 

IPC_STAT Place the current value of each member of the 
data structure associated with msqid into the struc- 
ture pointed to by buf . The contents of this struc- 
ture are defined in intro (2). {READ} 

IPC_SET Set the value of the following members of the data 
structure associated with msgid to the correspond- 
ing value found in the structure pointed to by buf : 

msg_perm.uid 

msg_perm.gid 

msg_perm.mode /* only low 9 bits */ 

msg_qbytes 
This cmd can only be executed by a process that 
has an effective user ID equal to either that of 
super user or to the value of msg_perm.uid in the 
data structure associated with msgid . Only super 
user can raise the value of msg_qbytes . 

IPC_RMID Remove the message queue identifier specified by 
msqid from the system and destroy the message 
queue and data structure associated with it. This 
cmd can only be executed by a process that has 
an effective user ID equal to either that of super 
user or to the value of msg_perm.uid in the data 
structure associated with msqid . 

Msgct! will fail if one or more of the following are true: 

[EINVAL] Msqid is not a valid message queue identifier. 

[EINVAL] Cmd is not a valid command. 

Page 1 May 22, 1985 


MSGCTL(2) 


[EACCES] 


[EPERM] 


[EPERM] 


[EFAULT] 
RETURN VALUE 


UNIX Sys5 MSGCTL (2) 


Cmd is equal to IPC_STAT and {READ} operation —_ 
permission is denied to the calling process (see_ 
intro (2)). 4 


Cmd is equal to IPC_RMID or IPC_SET . The effec- 
tive user ID of the calling process is not equal to 
that of super user and it is not equal to the value of 
msg_perm.uid in the data structure associated 
with msqid . | 


Cmd is equal to IPC_SET, an attempt is being 
made to increase to the value of msg_qbytes, and 
the effective user ID of the calling process is not 
equal to that of super user. 


Buf points to an illegal address. 


Upon successful completion, a value of 0 is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the error. 


SEE ALSO 


intro(2), msgget(2), msgop(2). 
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_. NAME 
( ; msgget — get message queue 

“-" SYNOPSIS 
#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/msg.h> 
int msgget (key, msgflg) 
key_t key; 
int msgfig; 

DESCRIPTION 


Msgget returns the message queue identifier associated with key . 


A message queue identifier and associated message queue and 
data structure (see intro (2)) are created for key if one of the follow- 
ing are true: 


10 Key is equal to IPC_PRIVATE . 


Key does not already have a message queue identifier 
associated with it, and (msgfig & IPC_CREAT ) is “true”. 


Upon creation, the data structure associated with the new message 
queue identifier is initialized as follows: 


Msg_perm.cuid , msg_perm.uid , msg_perm.cgid , and 
msg_perm.gid are set equal to the effective user ID and 
effective group ID, respectively, of the calling process. 


The low-order 9 bits of msg_perm.mode are set equal to 
the low-order 9 bits of msgfig . 


Msg_qnum , msg_Ispid , msg_Irpid , msg_stime , and 
msg_rtime are set equal to 0. 


Msg_ctime is set equal to the current time. 
Msg_qbytes is set equal to the system limit. 
Msgget will fail if one or more of the following are true: 


[EACCES] A message queue identifier exists for key , but 
operation permission (see intro (2)) as specified by 
the low-order 9 bits of msgflg would not be 
granted. 


[ENOENT] A message queue identifier does not exist for key 
and (msgflg & IPC_CREAT ) is “false”. 
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[ENOSPC] A message queue identifier is to be created but the 
system-imposed limit on the maximum number of ! 
allowed message queue identifiers system wide.” 
would be exceeded. 


[EEXIST] A message queue identifier exists for key but ( ( 
msgfig & IPC_CREAT) & ( msgfig & IPC_EXCL ) ) 
is “true”. 


RETURN VALUE 
Upon successful completion, a non-negative integer, anal a mes- 
sage queue identifier, is returned. Otherwise, a value of —1 is 
returned and errno is set to indicate the error. 


SEE ALSO | 
intro(2), msgcti(2), msgop(2).. 


ie Pek 
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NAME 
msgop — message operations 
SYNOPSIS 
#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/msg.h> 
int msgsnd (msqid, msgp, msgsz, msgflig) 
int msqid; 
struct msgbuf *msgp; 
int msgsz, msgafig; 
int msgrcv (msqid, msgp, msgsz, msgtyp, msgflg) 
int msqid; 
struct msgbuf *msgp; 
int msgsz; 
long msgtyp; 
int msgflg; 
DESCRIPTION 
Msgsnd is used to send a message to the queue associated with 
the message queue identifier specified by msqid . {WRITE} Msgp 
points to a structure containing the message. This structure is com- 
posed of the following members: 
long mtype; /* message type */ 
char mtext([]; /* message text */ 
Mtype is a positive integer that can be used by the receiving pro- 
cess for message selection (see msgrcv below ). Mtext is any text 
of length msgsz bytes. Msgsz can range from 0 to a system- 
imposed maximum. 
Msgilg specifies the action to be taken if one or more of the follow- 
ing are true: 
The number of bytes already on the queue is equal to 
msg_qbytes (see intro (2)). 
The total number of messages on all queues system-wide is 
equal to the system-imposed limit. 
These actions are as follows: 
If ( msgfig & IPC_NOWAIT ) is “true”, the message will not 
be sent and the calling process will return immediately. 
lf ( msgflg & IPC_NOWAIT ) is “false”, the calling process 
will suspend execution until one of the following occurs: 
The condition responsible for the suspension no 
longer exists, in which case the message is sent. 
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Msqid is removed from the system (see msgct/ 
(2)). When this occurs, errno is set equal to ~ ™~ 
EIDRM, and a value of —1 is returned. = oy 


The calling process receives a signal that is to be 
caught. In this case the message is not sent and 
the calling process resumes execution in the 
manner prescribed in signal (2)). 


Msgsnd will fail and no message will be sent if one or more of the 
following are true: 


[EINVAL] Msqid is not a valid message queue identifier. 


[EACCES] Operation permission is denied to the calling pro- 
cess (see intro (2)). 

[EINVAL] Mtype is less than 1. | 

[EAGAIN] The message cannot be sent for one of the rea- 
sons cited above and ( msgfig & IPC_NOWAIT ) is 
“true”. 

[EINVAL] Msgsz is less than zero or greater than the 


system-imposed limit. 
[EFAULT] Msgp points to an illegal address. 


Upon successful completion, the following actions are taken with = . 


respect to the data structure associated with msqid (see intro (2)). 
Msg_qnum is incremented by 1. 
Msg_Ispid is set equal to the process ID of the calling pro- 
cess. 
Msg_stime is set equal to the current time. 
Msgrcv reads a message from the queue associated with the mes- 
sage queue identifier specified by msqid and places it in the struc- 
ture pointed to by msgp . {READ} This structure is composed of the 
following members: : 
long mtype; /* message type */ 
char mtext([]; /* message text «/ 
Mtype is the received message's type as specified by the sending 
process. Mtext is the text of the message. Msgsz specifies the 
size in bytes of mtext. The received message is truncated to msgsz 
bytes if it is larger than msgsz and ( msgflg & MSG_NOERROR ) is 
“true”. The truncated part of the message is lost and no indication 
of the truncation is given to the calling process. o~ 
Msgtyp specifies the type of message requested as follows: < / 


If msgtyp is equal to 0, the first message on the queue is 
received. 
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If msgtyp is greater than 0, the first message of type 
msgtyp is received. 


lf msgtyp is less than 0, the first message of the lowest 
type that is less than or equal to the absolute value of 
msgtyp is received. 


Msgflg specifies the action to be taken if a message of the desired 
type is not on the queue. These are as follows: 


If ( msgflg & IPC_NOWAIT ) is “true”, the calling process 
will return immediately with a return value of —1 and errno 
set to ENOMSG. 


If ( msgflg & IPC_NOWAIT ) is “false”, the calling process 
will suspend execution until one of the following occurs: 


A message of the desired type is placed on the 
queue. 


Msqid is removed from the system. When this 
occurs, errno is set equal to EIDRM, and a value of 
—1 is returned. 


The calling process receives a signal that is to be 
caught. In this case a message is not received 
and the calling process resumes execution in the 
manner prescribed in signal (2)). 


Msgrcv will fail and no message will be received if one or more of 
the following are true: 


[EINVAL] 
[EACCES] 


[EINVAL] 
[E2BIG] 


[ENOMSG] 


[EFAULT] 


Msqid is not a valid message queue identifier. 


Operation permission is denied to the calling pro- 
cess. 


Msgsz ts less than 0. 


Mtext is greater than msgsz and ( msgiflg & 
MSG_NOERROR ) is ‘false’. 


The queue does not contain a message of the 
desired type and ( msgtyp & IPC_NOWAIT ) is 
“true”. 


Msgp points to an illegal address. 


Upon successful completion, the following actions are taken with 
respect to the data structure associated with msqid (see intro (2)). 


Msg_qnum is decremented by 1. 


Msg_irpid is set equal to the process ID of the calling pro- 


cess. 
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Msg_rtime is set equal to the current time. 


RETURN VALUES _, 
If msgsnd or msgrcv return due to the receipt of a signal, a value \__/ 
of —1 is returned to the calling process and errno is set to EINTR. If 
they return due to removal of msgid from the system, a value of —1 
is returned and errno is set to EIDRM. 


Upon successful completion, the return value is as follows: 
Msgsnd returns a value of 0. 


Msgrcv returns a value equal to the number of bytes actu- 
ally placed into mtext . 


Otherwise, a value of —1 is returned and errno is set to indicate the 
error. 


SEE ALSO 
intro(2), msgctl(2), msgget(2), signal(2). 
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NAME 
( nice — change priority of a process 


~ SYNOPSIS 
int nice (incr) 
int incr; 
DESCRIPTION 
Nice adds the value of incr to the nice value of the calling process. 
A process's nice value is a positive number for which a more posi- 
tive value results in lower CPU priority. 


A maximum nice value of 39 and a minimum nice value of 0 are 
imposed by the system. Requests for values above or below these 
limits result in the nice value being set to the corresponding limit. 


[EPERM] Nice will fail and not change the nice value if incr 
is negative or greater than 40 and the effective 
user ID of the calling process is not super-user. 


RETURN VALUE 
Upon successful completion, nice returns the new nice value minus 
20. Otherwise, a value of —1 is returned and errno is set to indicate 


the error. 
_. SEE ALSO 
( exec(2). 
er nice(1) in the Sys5 UNIX User Reference Manual. 
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NAME 
open — open for reading or writing | of 
\ : 


SYNOPSIS | Loe: 
#include <fcntl.h> . 
int open (path, oflag [ , mode ] ) 
char *path; 
int oflag, mode; 


DESCRIPTION 
Path points to a path name naming a file. Open opens a file 
descriptor for the named file and sets the file status flags according 
to the value of offag . Offag values are constructed by or-ing flags 
from the following list ony one of the first three flags below may be 
used): 


O_RDONLY Open for reading only. 
O_WRONLY Open for writing only. 
O_RDWR Open for reading and writing. 


O NDELAY This flag may affect subsequent reads and writes. 
See read (2) and write (2). 


When opening a FIFO with O_RDONLY or O_WRONLY 
set: f—o™ 


lf O_NDELAY is set: . | ue” 


An open for reading-only will return without 
delay. An open for writing-only will return an 
error if no process currently has the file open 
for reading. 


~ If O_NDELAY is clear: 


An open for reading-only will block until a pro- 
cess opens the file for writing. An open for 
writing-only will block until a process opens 
the file for reading. 


When opening a file associated with a communication 
line: 


If O_NDELAY is set: 


The open will return without waiting for car- 
rier. 


If O_NDELAY is clear: 
The open will block until carrier is present. -_ 


O_APPEND ff set, the file pointer will be set to the end of the file \—~ 
prior to each write. 
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O_CREAT 


O_TRUNC 


O_EXCL 
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If the file exists, this flag has no effect. Otherwise, 
the owner ID of the file is set to the effective user ID of 
the process, the group ID of the file is set to the effec- 
tive group ID of the process, and the low-order 12 bits 
of the file mode are set to the value of mode modified 
as follows (see creat (2)): 


All bits set in the file mode creation mask of 
the process are cleared. See umask (2). 


The “save text image after execution bit” of 
the mode is cleared. See chmod (2). 


If the file exists, its length is truncated to 0 and the 
mode and owner are unchanged. 


lf O_EXCL and O_CREAT are set, open will fail if the 
file exists. 


The file pointer used to mark the current position within the file is set 
to the beginning of the file. 


The new file descriptor is set to remain open across exec system 
calls. See fentl (2). 


The named file is opened unless one or more of the following are 


true: 
(ENOTDIR] 
[ENOENT] 


[EACCES] 


[EACCES] 
[EISDIR] 
[EROFS] 


[EMFILE] 
[ENXIO] 


[ETXTBSY] 


[EFAULT] 
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A component of the path prefix is not a directory. 


O_CREAT is not set and the named file does not 
exist. 


A component of the path prefix denies search per- 
mission. 


Oflag permission is denied for the named file. 


The named file is a directory and oflag is write or 
read/write. 


The named file resides on a read-only file system 
and oflag is write or read/write. 


Twenty (20) file descriptors are currently open. 


The named file is a character special or block spe- 
cial file, and the device associated with this special 
file does not exist. | 


The file is a pure procedure (shared text) file that is 
being executed and oflag is write or read/write. 


Path points outside the allocated address space of 
the process. 
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[EEXIST] O_CREAT and O_EXCL are set, and the named file 
exists. ~ 
[ENXIO] | O_NDELAY is set, the named file is a FIFO, ee 
O_WRONLY is set, and no process has the file open 
for reading. 
[EINTR] A signal was caught during the open system call. 
[ENFILE] The system file table is full. 


RETURN VALUE 
Upon successful completion, the file descriptor is returned. Other- 
wise, a value of —1 is returned and errno is set to indicate the error. 


SEE ALSO 
chmod(2), close(2), creat(2), dup(2), fentl(2), Iseek(2), read(2), 
umask(2), write(2). : 
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—. NAME 
pause — suspend process until signal 


~ SYNOPSIS 
pause () 


DESCRIPTION . 
Pause suspends the calling process until it receives a signal. The 
signal must be one that is not currently set to be ignored by the cal- 
ling process. 


If the signal causes termination of the calling process, pause will not 
return. 


If the signal is caught by the calling process and control is returned 
from the signal-catching function (see signa/ (2)), the calling pro- 
cess resumes execution from the point of suspension; with a return 
value of —1 from pause and errno set to EINTR. 


SEE ALSO 
alarm(2), kill(2), signal(2), wait(2). 
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NAME yer 
pipe — create an interprocess channel ( 


SYNOPSIS 
int pipe (fildes) 
int fildes[2]; 


DESCRIPTION 
Pipe creates an 1/O mechanism called a pipe and returns two file 
descriptors, fildes [0] and fildes [1]. Fildes [0] is opened for reading 
and fildes [1] is opened for writing. 


Up to 5120 bytes of data are buffered by the pipe before the writing 
process is blocked. A read only file descriptor fildes [0] accesses 
the data written to fildes [1] on a first-in-first-out (FIFO) basis. 


[EMFILE] Pipe will fail if 19 or more file descriptors are 
currently open. 
(ENFILE}] The system file table is full. 


RETURN VALUE 
Upon successful completion, a value of 0 is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the error, 


ao 
SEE ALSO C 
read(2), write(2). 2 
sh(1) in the Sys5 UNIX User Reference Manual. 
a 
ae 
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_ NAME 


plock — lock process, text, or data in memory 


SYNOPSIS 
#include <sys/lock.h> 


int plock (op) 
int op; 


DESCRIPTION 
Plock allows the calling process to lock its text segment (text lock), 
its data segment (data lock), or both its text and data segments 
(process lock) into memory. Locked segments are immune to all 
routine swapping. Plock also allows these segments to be 
unlocked. The effective user ID of the calling process must be 
super-user to use this call. Op specifies the following: 


PROCLOCK - lock text and data segments into memory 
(process lock) 


TXTLOCK - lock text segment into memory (text lock) 
DATLOCK- __ lock data segment into memory (data lock) 
UNLOCK - remove locks 


Plock will fail and not perform the requested operation if one or 
more of the following are true: 


[EPERM] The effective user ID of the calling process is not 
super-user. 

[EINVAL] Op is equal to PROCLOCK and a process lock, a 
text lock, or a data lock already exists on the cal- 
ling process. 

[EINVAL] Op is equal to TXTLOCK and a text lock, or a pro- 
cess lock already exists on the calling process. 

[EINVAL] Op is equal to DATLOCK and a data lock, or a pro- 
cess lock already exists on the calling process. 

[EINVAL] Op is equal to UNLOCK and no type of lock exists 


on the calling process. 


RETURN VALUE 
Upon successful completion, a value of 0 is returned to the calling 
process. Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 


exec(2), exit(2), fork(2). 
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NAME 
profil — execution time profile 
SYNOPSIS | 
void profil (buff, bufsiz, offset, scale) 
char +*buff; | 
int bufsiz, offset, scale; 
DESCRIPTION 


Buff points to an area of core whose length (in bytes) is given by 
bufsiz . After this call, the user's program counter (pc) is examined 
each clock tick (60th second); offset is subtracted from it, and the 
result multiplied by scale . If the resulting number corresponds to a 
word inside buff , that word is incremented. 


The scale is interpreted as an unsigned, fixed-point fraction with 
binary point at the left: 0177777 (octal) gives a 1-1 mapping of pc's 
to words in buff ; 077777 (octal) maps each pair of instruction words 
together. O2(octal) maps all instructions onto the beginning of buff 
(producing a non-interrupting core clock). 


Profiling is turned off by giving a sca/e of O or 1. It is rendered inef- 
fective by giving a bufsiz of 0. Profiling is turned off when an exec 
is executed, but remains on in child and parent both after a fork . 


Profiling will be turned off if an update in buff would cause a : 


memory fault. 


RETURN VALUE 


Not defined. 


SEE ALSO 
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prof(1) in the Sys5 UNIX User Reference Manual. 
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NAME 


ptrace — process trace 


SYNOPSIS 


int ptrace (request, pid, addr, data); 
int request, pid, addr, data; 


DESCRIPTION 


Ptrace provides a means by which a parent process may control the 
execution of a child process. Its primary use is for the implementa- 
tion of breakpoint debugging. The child process behaves normally 
until it encounters a signal (see signal (2) for the list), at which time 
it enters a stopped state and its parent is notified via wait (2). When 
the child is in the stopped state, its parent can examine and modify 
its “core image” using ptrace . Also, the parent can cause the child 
either to terminate or continue, with the possibility of ignoring the 
signal that caused it to stop. 


The request argument determines the precise action to be taken by 
ptrace and is one of the following: 


0 This request must be issued by the child process if it 
is to be traced by its parent. It turns on the child’s 
trace flag that stipulates that the child should be left in 
a stopped state upon receipt of a signal rather than 
the state specified by func ; see signal (2). The pid , 
addr , and data arguments are ignored, and a return 
value is not defined for this request. Peculiar results 
will ensue if the parent does not expect to trace the 
child. 


_ The remainder of the requests can only be used by the parent pro- 
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cess. For each, pid is the process ID of the child. The child must 
be in a stopped state before these requests are made. 


1,2 With these requests, the long at location adar in the 
address space of the child is returned to the parent 
process. If | and D space are not separated, either 
request 1 or request 2 may be used with equal results. 
The data argument is ignored. These two requests 
will fail if addr is not the start address of a long, in 
which case a value of —1 is returned to the parent pro- 
cess and the parent's errno is set to ElO. 


3 With this request, the word long at location addr in 
the child’s USER area in the system’s address space 
(see <sys/user.h>) is returned to the parent pro- 
cess. Addresses in this area range from 0 to 4096. 
The data argument is ignored. This request will fail if 
adar is not the start address of a word or is outside 
the USER area, in which case a value of —1 Is returned 
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to the parent process and the parent's errno is set to 
EIO. a, 


4,5 With these requests, the long value given by the data ae, 
argument is written into the address space of the child 
at location adar . Either request 4 or request 5 may be 
used with equal results. Upon successful completion, 
the value written into the address space of the child is 
returned to the parent. These two requests will fail if 
addr is a location in a pure procedure space and 
another process is executing in that space, or addr is 
not the start address of a word. Upon failure a value 
of —1 is returned to the parent process and the 
parent’s errno is set to ElO. 


6 With this request, a few entries in the child’s USER 
area can be written. Data gives the value that is to be 
written and addr is the location of the entry. The few 
entries that can be written are: 


the general registers (i.e., registers AO-A7 and 
DO-D7 


the condition codes of the Processor Status 
Word a 


7 This request causes the child to resume execution. If \.” 
the data argument is 0, all pending signals including 
the one that caused the child to stop are canceled 
before it resumes execution. If the data argument is a 
valid signal number, the child resumes execution as if 

_ it had incurred that signal, and any other pending sig- 
nals are canceled. The addr argument must be equal 
to 1 for this request. Upon successful completion, the 
value of data is returned to the parent. This request 
will fail if data is not O or a valid signal number, in 
which case a value of —1 is returned to the parent pro- 
cess and the parent's errno is set to EIO. 


8 This request causes the child to terminate with the 
same consequences as exif(2). 
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9 This request sets the trace bit in the Processor Status 
Word of the child (i.e., bit 15 and then executes the 
same steps as listed above for request 7. The trace 
bit causes an interrupt upon completion of one 
machine instruction. This effectively allows single 
stepping of the child. | 


10 This request attaches a debugger to a process. The 
calling process becomes the debugger for the process 
pid. This is similar to request O being made by the 
process being attached. The process does not stop at 
this time. The debugger must send a signal to the 
process to stop it. If the attached process does a fork 
the child inherits the debugger and gets a SIGTRAP 
before it starts execution. The debugger will therefore 
get notification of the new process. Only processes 
which the caller has the right to send a signal to may 
be attached. 


11. This request detaches the debugger. This undoes the 
effect of an attach to a process. Children of the pro- 
cess being detached will not be affected. Children 
must each be deliberately detached. 


12 This request returns the parent process id for the pro- 
cess pid. 


13 This request copies the contents of the u_comm area 
of the process pid to adar. 


To forestall possible fraud, pfrace inhibits the set-user-id facility on 
subsequent exec (2) calls. If a traced process calls exec , it will 
stop before executing the first instruction of the new image showing 
signal SIGTRAP . 


GENERAL ERRORS 


Ptrace will in general fail if one or more of the following are true: 
[EIO] Request is an illegal number. 


[ESRCH] Pid identifies a child that does not exist or has not 
executed a ptrace with request 0. 


SEE ALSO 
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NAME | : 
read — read from file — 


SYNOPSIS <2 
int read (fildes, buf, nbyte) : 
int fildes; 
char +*buf; 
unsigned nbyte; 


DESCRIPTION 
a2 Fildes is a file descriptor obtained from a creat, open, dup , fentl, 
or pipe system call. 


Read attempts to read nbyte bytes from the file associated with 
fildes into the buffer pointed to by buf. 


On devices capable of seeking, the read starts at a position in the 
file given by the file pointer associated with fildes . Upon return from 
read , the file pointer is incremented by the number of bytes actually 
read. 


Devices that are incapable of seeking always read from the current 
position. The value of a file pointer associated with such a file is 
undefined. 


Upon successful completion, read returns the number of bytes actu- -- 
ally read and placed in the buffer; this number may be less than | 

-- nbyte if the file is associated with a communication line (see jocth ~ 
(2) and termio (7)), or if the number of bytes left in the file is less 
than nbyte bytes. A value of 0 is returned when an end-of-file has 
been reached. 


When attempting to read from an empty pipe (or FIFO): 
If O_NDELAY is set, the read will return a 0. 


If O_NDELAY is clear, the read will block until data is written 
to the file or the file is no longer open for writing. 


When attempting to read a file associated with a tty that has no data 
currently available: 


If O_NDELAY is set, the read will return a 0. 


If O_NDELAY is clear, the read will block until data becomes 
available. 


Read will fail if one or more of the following are true: 
[EBADF] Fildes is not a valid file descriptor open for reading. 
[EFAULT] Buf points outside the allocated address space. Pa 
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ete [EINTR] A signal was caught during the read system call. 
( RETURN VALUE | | 
Upon successful completion a non-negative integer is returned indi- 
cating the number of bytes actually read. Otherwise, a -1 is 
returned and errno is set to indicate the error. 


SEE ALSO : 
creat(2), dup(2), fentl(2), ioctl(2), open(2), pipe(2). 
termio(7) in the Sys5 UNIX Administrator Reference Manual. 
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NAME , 
semctl — semaphore control operations wt on 


SYNOPSIS | - aa 
#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/sem.h> 


int semctl (semid, semnum, cmd, arg) 
int semid, cmd; 
int semnum; 
union semun { 
int val; 
struct semid_ds «buf; 
ushort *array; 
} arg; 
DESCRIPTION 
Semctl provides a variety of semaphore control operations as speci- 
fied by cmd. 


The following cmd s are executed with respect to the semaphore 
specified by semid and semnum: 


GETVAL Return the value of semval (see intro (2)). ~~ 
{READ} q 


SETVAL Set the value of semval to arg.va/l . {ALTER} 
When this cmd is successfully executed, the 
semadj value corresponding to the specified 
semaphore in all processes is cleared. 
GETPID Return the value of sempid. {READ} 
GETNCNT Return the value of semncnt. {READ} 
GETZCNT Return the value of semzcnt. {READ} 
The following cmd s return and set, respectively, every semval in 
the set of semaphores. 
GETALL Place semvals into array pointed to by 
arg.array . {READ} 
SETALL Set semvals according to the array pointed to 
by arg.array . {ALTER} When this cmd is suc- 
cessfully executed the semadj values 
corresponding to each specified semaphore in 
all processes are cleared. 
The following cmd s are also available: a - 
ee 
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IPC_STAT 


IPC_SET 


IPC_RMID 
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Place the current value of each member of the 
data structure associated with semid into the 
structure pointed to by arg.buf . The contents 
of this structure are defined in intro (2). {READ} 


Set the value of the following members of the 
data structure associated with semid to the 
corresponding value found in the structure 
pointed to by arg. buf : 

sem_perm.uid 

sem_perm.gid 

sem_perm.mode /* only low 9 bits */ 


This cmd can only be executed by a process 
that has an effective user ID equal to either that 
of super-user or to the value of sem_perm.uid 
in the data structure associated with semid . 


Remove the semaphore identifier specified by 
semid from the system and destroy the set of 
semaphores and data structure associated with 
it. This cmd can only be executed by a pro- 
cess that has an effective user ID equal to 
either that of super-user or to the value of 
sem_perm.uid in the data structure associated 
with semid . 


Semcti will fail if one or more of the following are true: 


[EINVAL] 
[EINVAL] 


[EINVAL] 
[EACCES] 


[ERANGE] 


[EPERM] 


[EFAULT] 


Semid is not a valid semaphore identifier. 


Semnum is less than zero or greater than 
sem_nsems. 


Cmd is not a valid command. 


Operation permission is denied to the cal- 
ling process (see intro (2)). 


Cmd is SETVAL or SETALL and the value 
to which semval is to be set is greater than 
the system imposed maximum. 


Cmd is equal to iPC_RMID or IPC_SET and 
the effective user ID of the calling process 
is not equal to that of super-user and it is 
not equal to the value of sem_perm.uid in 
the data structure associated with semid . 


Arg.buf points to an illegal address. 
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RETURN VALUE : 


Upon successful completion, the value returned depends on cmd as -_ 
follows: | ae 

GETVAL The value of semval. 

GETPID The value of sempid. 

GETNCNT The value of semncnt. 

GETZCNT The value of semzcnt. 

All others A value of 0. | 
Otherwise, a value of —1 is returned and errno is set to indicate the | 
error. | 

SEE ALSO 
intro(2), semget(2), semop(2). 
ie, 
Nl 
—_— 
S97 
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semget — get set of semaphores 


~ SYNOPSIS 


#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/sem.h> 


int semget (key, nsems, semflg) 


key_t key; 


int nsems, semflg; 


DESCRIPTION 
Semget returns the semaphore identifier associated with key . 


A semaphore identifier and associated data structure and set con- 
taining nsems semaphores (see intro (2)) are created for key if one 
of the following are true: 


Key is equal to IPC_PRIVATE . 


Key does not already have a semaphore identifier associ- 
ated with it, and (semflg & IPC_CREAT ) is “true”. 


Upon creation, the data structure associated with the new sema- 
phore identifier is initialized as follows: 


Sem_perm.cuid , sem_perm.uid , sem_perm.cgid , and 
sem_perm.gid are set equal to the effective user ID and 
effective group ID, respectively, of the calling process. 


The low-order 9 bits of sem_perm.mode are set equal to 
the low-order 9 bits of semfig . 


Sem_nsems is set equal to the value of nsems . 


Sem_otime is set equal to 0 and sem_ctime is set equal to 
the current time. 


Semget will fail if one or more of the following are true: 


[EINVAL] 


[EACCES] 


we 


[EINVAL] 


[ENOENT] 
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Nsems is either less than or equal to zero or 
greater than the system-imposed limit. 


A semaphore identifier exists for key , but opera- 
tion permission (see intro (2)) as specified by the 
low-order 9 bits of semflg would not be granted. 


A semaphore identifier exists for key , but the 
number of semaphores in the set associated with it 
is less than nsems and nsems is not equal to 
zero. 


A semaphore identifier does not exist for key and ( 
semflg & IPC_CREAT ) is “false”. 
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[ENOSPC] A semaphore identifier is to be created but the 


system-imposed limit on the maximum number of ~ 


allowed semaphore identifiers system wide would \ 


be exceeded. 


[ENOSPC] A semaphore identifier is to be created but the 
system-imposed limit on the maximum number of 
allowed semaphores system wide would be 


exceeded. 

[EEXIST] A semaphore identifier exists for key but ( ( semflg 
& IPC_CREAT) and { semflg & IPC_EXCL ) ) is 
“true”. - 


RETURN VALUE | 
Upon successful completion, a non-negative integer, namely a 
semaphore identifier, is returned. Otherwise, a value of —1 is 
returned and errno is set to indicate the error. 


SEE ALSO 
intro(2), semctl(2), semop(2). 
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NAME 


semop — semaphore operations 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/sem.h> 


int semop (semid, sops, nsops) 
int semid; 

struct sembuf **sops; 

int nsops; 


DESCRIPTION 
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Semop is automatically performs an array of semaphore operations 
on the set of semaphores associated with the semaphore identifier 
specified by semid. Sops is a pointer to the array of semaphore- 
operation structures. Nsops is the number of such structures in the 
array. The contents of each structure includes the following: 


short sem_num;  /* semaphore number */ 
short sem_op; /* semaphore operation «/ 
short sem_flg; /* operation flags */ 


Each semaphore operation specified by sem_op is performed on 
the corresponding semaphore specified by semid and sem_num. 


Sem_op specifies one of three semaphore operations as follows: 


If sem_op is a negative integer, one of the following will occur: 
{ALTER} 


If semval (see intro (2)) is greater than or equal to the abso- 
lute value of sem_op, the absolute value of sem_op is sub- 
tracted from semval. If (sem_flg & SEM_UNDO) is ‘true’, the 
absolute value of sem_op is added to the calling process’s 
semadj value (see exit (2)) for the specified semaphore. 


If semval is less than the absolute value of sem_op and 
(sem_flg & IPC_NOWAIT) is “true”, semop will return immedi- 
ately. 


If semval is less than the absolute value of sem_op and 
(sem_flg & IPC_NOWAIT) is “false”, semop will increment the 
semncnt associated with the specified semaphore and 
suspend execution of the calling process until one of the fol- 
lowing conditions occur. 


Semval becomes greater than or equal to the absolute 
value of sem_op . When this occurs, the value of 
semncnt associated with the specified semaphore is 
decremented, the absolute value of sem_op is sub- 
tracted from semval and, if ( sem_flg & SEM_UNDO ) 
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s “true”, the absolute value of sem_op is added to the 
calling process's semadj value for the specified sema-“ 
phore. 7, 


The semid for which the calling process is awaiting 
action is removed from the system (see semciti (2)). 
When this occurs, errno is set equal to EIDRM, and a 
value of —1 is returned. 


The calling process receives a signal that is to be 
caught. When this occurs, the value of semncnt asso- 
ciated with the specified semaphore is decremented, 
and the calling process resumes execution in the 
manner prescribed in signal (2). 


If sem_op is a positive integer, the value of sem_op is added to 
semval and, if (sem_flg & SEM_UNDO) is “true”, the value of 
sem_op is subtracted from semadj value of the calling process for 
the specified semaphore. {ALTER} 


lf sem_op is zero, one of the following will occur: {READ} 
If semval is zero, semop will return immediately. 


If semval is not equal to zero and (sem_fig & IPC_NOWAIT) is 
“true”, semop will return immediately. ee 


If semval is not equal to zero and (sem_fig & IPC_NOWAIT ‘or 2 Z 
is “false”, semop will increment the semzcnt associated with 

the specified semaphore and suspend execution of the calling 
process until one of the following occurs: 


Semval becomes zero, at which time the value of 
-semzcnt associated with the specified semaphore is 
decremented. 


The semid for which the calling process is awaiting 
action is removed from the system. When this occurs, 
errno is set equal to EIDRM, and a value of —1 is 
returned. 


The calling process receives a signal that is to be 
caught. When this occurs, the value of semzcnt asso- 
ciated with the specified semaphore is decremented, 
and the calling process resumes execution in the 
manner prescribed in signal (2). 


October 9, 1986 Page 2 


i sy 
( 


SEMOP(2) UNIX Sys5 SEMOP(2) 


Semop will fail if one or more of the following are true for any of the 
semaphore operations specified by sops : 


[EINVAL] Semid is not a valid semaphore identifier. 

(EFBIG] Sem_num is less than zero or greater than or equal 
to the number of semaphores in the set associated 
with semid . 

[E2BIG] Nsops is greater than the: system-imposed max- 
imum. 

[EACCES] Operation permission is denied to the calling pro- 
cess (see intro (2)). 

[EAGAIN] The operation would result in suspension of the 
calling process but ( sem_flg & IPC_NOWAIT ) is 
“true”. 

[ENOSPC] The limit on the number of individual processes 


requesting an SEM_UNDO would be exceeded. 


[EINVAL] _ The number of individual semaphores for which the 
calling process requests a SEM_UNDO would 
exceed the limit. | 


[ERANGE] An operation would cause a semval to overflow the 
system-imposed limit. 

[ERANGE] An operation would cause a semadj value to over- 
flow the system-imposed limit. 

[EFAULT] Sops points to an illegal address. 


Upon successful completion, the value of sempid for each sema- 
phore specified in the array pointed to by sops is set equal to the 
process ID of the calling process. 


RETURN VALUE 


lf semop returns due to the receipt of a signal, a value of —1 is 
returned to the calling process and errno is set to EINTR. If it 
returns due to the removal of a semid from the system, a value of 
—1 is returned and errno is set to EIDRM. 


Upon successful completion, the value of semval at the time of the 
call for the last operation in the array pointed to by sops is returned. 
Otherwise, a value of —1 is returned and errno is set to indicate the 
error. 


SEE ALSO 


exec(2), exit(2), fork(2), intro(2), semctl(2), semget(2). 
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NAME 

setpgrp — set process group ID 
SYNOPSIS 

int setpgrp () 
DESCRIPTION 


Setpgrp sets the process group ID of the calling process to the pro- 
cess ID of the calling process and returns the new process group ID. 


RETURN VALUE 
Setpgrp returns the value of the new process group ID. 


SEE ALSO 
exec(2), fork(2), getpid(2), intro(2), kill(2), signal(2). 
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NAME = 
setuid, setgid — set user and group IDs > 
te. 
SYNOPSIS A 
int setuid (uid) 
int uid; 
int setgid (gid) 
int gid; 
DESCRIPTION 
Setuid ( setgid ) is used to set the real user (group) ID and effec- 
tive user (group) ID of the calling process. 
If the effective user ID of the calling process is super-user, the real 
user (group) ID and effective user (group) ID are set to uid (gid ). 
If the effective user ID of the calling process is not Super-user, but 
its real user (group) ID is equal to uid ( gid ), the effective user 
(group) ID is set to uid (gid ). 
If the effective user ID of the calling process is not super-user, but 
the saved set-user (group) ID from exec(2) is equal to uid (gid), the 
effective user (group) !D is set to uid (gid). 
Setuid ( setgid ) will fail if the real user (group) ID of the calling pro- 

. , : ; : —, 
cess is not equal to uid ( gid ) and its effective user ID is not | 
super-user. [EPERM] wey 
The uid is out of range. [EINVAL] 

RETURN VALUE | 
Upon successful completion, a value of 0 is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the error. 
SEE ALSO 
getuid(2), intro(2). 
_ | 
Nes 
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shmctl — shared memory control operations 


. SYNOPSIS 
#include <sys/types.h> 
#include <sys/ipc.h> 

#include <sys/shm.h> 


int shmctl (shmid, cmd, buf) 


int shmid, cmd; 


struct shmid_ds *buf; 


DESCRIPTION 
Shmctl provides a variety of shared memory control operations as 
specified by cmd. The following cmd s are available: 


IPC_STAT 


IPC_SET 


IPC_RMID 


Place the current value of each member of the 
data structure associated with shmid into the 
structure pointed to by buf . The contents of 
this structure are defined in intro (2). {READ} 


Set the value of the following members of the 
data structure associated with shmid to the 
corresponding value found in the structure 
pointed to by buf : 

shm_perm.uid 

shm_perm.gid 

shm_perm.mode /* only low 9 bits «/ 


This cmd can only be executed by a process 
that has an effective user ID equal to either that 
of super-user or to the value of shm_perm.uid 
in the data structure associated with shmid . 


Remove the shared memory identifier specified 
by shmid from the system and destroy the 
shared memory segment and data structure 
associated with it. This cmd can only be exe- 
cuted by a process that has an effective user 
ID equal to either that of super-user or to the 
value of shm_perm.uid in the data structure 
associated with shmid . 


Shmct! will fail if one or more of the following are true: 


[EINVAL] 


[EINVAL] 
[EACCES] 


Shmid is not a valid shared memory iden- 
tifier. 
Cmd is not a valid command. 


Cmd is equal to IPC_STAT and {READ} 
operation permission is denied to the cal- 
ling process (see intro (2)). 
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[EPERM] Cmd is equal to IPC_RMID or IPC_SET and 


not equal to the value of shm_perm.uid in 
the data structure associated with shmid . 
[EFAULT] Buf points to an illegal address. 
RETURN VALUE | 
Upon successful completion, a value of 0 is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the error. 
SEE ALSO 
intro(2), shmget(2), shmop(2). 


5 
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NAME 
shmget — get shared memory segment 
SYNOPSIS 

#include <sys/types.h> 

#include <sys/ipc.h> 

#include <sys/shm.h> 

int shmget (key, size, shmflg) 

key_t key; 

int size, shmfig; 

DESCRIPTION 

Shmget returns the shared memory identifier associated with key . 

A shared memory identifier and associated data structure and 

shared memory segment of size size bytes (see intro (2)) are 

created for key if one of the following are true: 
Key is equal to IPC_PRIVATE . 
Key does not already have a shared memory identifier 
associated with it, and (shmflg & IPC_CREAT ) is “true”. 

Upon creation, the data structure associated with the new shared 

memory identifier is initialized as follows: 

Shm_perm.cuid , shm_perm.uid , shm_perm.cgid , and 
shm_perm.gid are set equal to the effective user ID and 
effective group ID, respectively, of the calling process. 

The low-order 9 bits of shm_perm.mode are set equal to 
the low-order 9 bits of shmflg . Shm_segsz is set equal to 
the value of size . 

Shm_Ipid , shm_nattch , shm_atime , and shm_dtime 
are set equal to 0. 

Shm_ctime is set equal to the current time. 

Shmget will fail if one or more of the following are true: 

[EINVAL] Size is less than the system-imposed minimum or 
greater than the system-imposed maximum. 

[EACCES] A shared memory identifier exists for key but 
operation permission (see intro (2)) as specified by 
the low-order 9 bits of shmflg would not be 
granted. 

[EINVAL] A shared memory identifier exists for key but the 
size of the segment associated with it is less than 
size and size is not equal to zero. 
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[ENOENT] 


[ENOSPC] 


[ENOMEM] 


[EEXIST] 


RETURN VALUE 
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A shared memory identifier does not exist for key _ 
and (shmfig & IPC_CREAT ) is “false”. 


a 
A shared memory identifier is to be created but the 


system-imposed limit on the maximum number of 
allowed shared memory identifiers system wide 
would be exceeded. 


A shared memory identifier and associated shared 
memory segment are to be created but the amount 
of available physical memory is not sufficient to fill 
the request. 


A shared memory identifier exists for key but ( ( 
shmflg & IPC_CREAT ) and { shmflg & IPC_EXCL ) 
) is “true”. 


Upon successful completion, a non-negative integer, namely a 
shared memory identifier is returned. Otherwise, a value of —1 is 
returned and errno is set to indicate the error. 


SEE ALSO 


intro(2), shmcetl(2), shmop(2). 
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shmop — shared memory operations 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/shm.h> 


char *shmat (shmid, shmaddr, shmflg) 
int shmid; 

char «shmaddr 

int shmflg; 


int shmdt (shmaddr) 
char *shmaddr 


DESCRIPTION 


Shmat attaches the shared memory segment associated with the 
shared memory identifier specified by shmid to the data segment of 
the calling process. The segment is attached at the address speci- 
fied by one of the following criteria: 


lf shmadar is equal to zero, the segment is attached at the 
first available address as selected by the system. 


If shmadar is not equal to zero and ( shmflg & SHM_RND) 
is “true”, the segment is attached at the address given by ( 
shmadar - (shmaddr modulus SHMLBA )). 


lf shmadar is not equal to zero and ( shmflg & SHM_RND) 
is “false”, the segment is attached at the address given by 
shmadear . 


Shmat detaches from the calling process's data segment 
the shared memory segment located at the address speci- 
fied by shmadar. 


Shmat will fail and not detach the shared memory segment 
if shmadadr is not the data segment start address of a 
shared memory segment. 


The segment is attached for reading if ( shmflg & SHM_RDONLY) is 
“true” {READ}, otherwise it is attached for reading and writing 
{READ/WRITE}. 


Shmat will fail and not attach the shared memory segment if one or 
more of the following are true: 


[EINVAL] Shmid is not a valid shared memory identifier. 


[EACCES] Operation permission is denied to the calling pro- 


cess (see intro (2)). 


[ENOMEM] The available data space is not large enough to 
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[EINVAL] Shmadadr is not equal to zero, and the value of ( 
shmadadr - ( shmaddr modulus SHMLBA )) is an 
illegal address. = 

[EINVAL] Shmadadr is not equal to zero, ( shmfig & 


SHM_RND) is “false”, and the value a shmaddr is 
an illegal address. 


[EMFILE}] The number of shared memory segments attached 
to the calling process would exceed the system- 
imposed limit. 


RETURN VALUES 
Upon successful completion, the return value is as follows: 


Shmat returns the data segment start address of the 
attached shared memory segment. 


Shmat returns a value of 0. 


Otherwise, a value of —1 is returned and errno is set to indicate the 
error. 


SEE ALSO 
exec(2), exit(2), fork(2), intro(2), shmctl(2), shmget(2). 


_ 
ee. 


April 3, 1986 Page 2 


SIGNAL(2) UNIX Sys5 SIGNAL (2) 


NAME 
signal — specify what to do upon receipt of a signal 


SYNOPSIS | 
#include <signal.h> 


int (*signal (sig, func))() 
int Sig; 
void (*func)(); 

DESCRIPTION 
Signal allows the calling process to choose one of three ways in 
which it is possible to handle the receipt of a specific signal. Sig 
specifies the signal and func specifies the choice. 


Sig can be assigned any one of the following except SIGKILL : 


SIGHUP 01 hangup 
SIGINT 02 interrupt 
SIGQUIT 03* = quit 
SIGILL 04* illegal instruction (not reset when caught) 
SIGTRAP 05* __ trace trap (not reset when caught) 
SIGIOT 06* = IOT instruction 
SIGEMT 07* EMT instruction 
SIGFPE 08* floating point exception 
SIGKILL 09 kill (cannot be caught or ignored) 
SIGBUS 10* bus error 
SIGSEGV 11* segmentation violation 
SIGSYS 12* bad argument to system call 
SIGPIPE 13 write On a pipe with no one to read it 
SIGALRM 14 alarm clock 
SIGTERM 15 software termination signal 
SIGUSA1 16 user-defined signal 1 
SIGUSR2~=17 user-defined signal 2 
SIGCLD 18 death of a child 

(see WARNING below) 
SIGPWR 19 power fail 

(see WARNING below) 


See below for the significance of the asterisk (*) in the above list. 


Func is assigned one of three values: SIG_DFL , SIG_IGN , or a 
function address . Following are descriptions of these values: 


SIG_DFL — terminate process upon receipt of a signal 
Upon receipt of the signal sig , the receiving process is 
to be terminated with all of the consequences outlined in 
exit (2). In addition a “core image” will be made in the 
Current working directory of the receiving process if s/g is 
one for which an asterisk appears in the above list and 
the following conditions are met: 
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The effective user ID and the real user ID of the 
receiving process are equal. 


ao, 


~ 


An ordinary file named core exists and is writable or aed 


can be created. If the file must be created, it will 
have the following properties: 


a mode of 0666 modified by the file creation 
mask (see umask (2)) 


a file owner ID that is the same as the effective 
user ID of the receiving process. 


a file group ID that is the same as the effective 
group ID of the receiving process 


SIG_IGN — ignore signal 


The signal sig is to be ignored. 
Note: the signal SIGKILL cannot be ignored. 


function address — catch signal 
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Upon receipt of the signal sig , the receiving process is to 
execute the signal-catching function pointed to by func . 
The signal number sig will be passed as the only argument 
to the signal-catching function. Additional arguments are 


passed to the signal-catching function for hardware- | 
generated signals. Before entering the signal-catching — 


function, the value of func for the caught signal will be set 
to SIG_DFL unless the signal is SIGILL , SIGTRAP , or 
SIGPWR . 


Upon return from the signal-catching function, the receiving 
process will resume execution at the point it was inter- 
rupted. 


When a signal that is to be caught occurs during a read, a 
write , an open, or an ioctl system call on a slow device 
(like a terminal; but not a file), during a pause system call, 
or during a wait system call that does not return immedi- 
ately due to the existence of a previously stopped or zom- 
bie process, the signal catching function will be executed 
and then the interrupted system call may return a —1 to the 
calling process with errno set to EINTR. 


Note: The signal SIGKILL cannot be caught. 
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7 A call to signal cancels a pending signal sig except for a pending 
( 7 SIGKILL signal. 


Signal will fail if sig is an illegal signal number, including SIGKILL . 
[EINVAL] 


RETURN VALUE 
Upon successful completion, signa/ returns the previous value of 
func for the specified signal sig . Otherwise, a value of —1 is 
returned and errno is set to indicate the error. 


SEE ALSO 
kill(2), pause(2), ptrace(2), wait(2), setjmp(3C). 
kill(1) in the Sys5 UNIX User Reference Manual. 


WARNING 
Two other signals that behave differently than the signals described 
above exist in this release of the system; they are: 


SIGCLD 18 death of a child (reset when caught) 
SIGPWR 19 power fail (not reset when caught) 


There is no guarantee that, in future releases of the UNIX system, 
these signals will continue to behave as described below; they are 
included only for compatibility with other versions of the UNIX sys- 
( .. tem. Their use in new programs is strongly discouraged. 
we 


For these signals, func is assigned one of three values: SIG_DFL , 
SIG_IGN , or a function address . The actions prescribed by these 
values of are as follows: 


SIG_DFL - ignore signal 
The signal is to be ignored. 


SIG_IGN - ignore signal 
The signal is to be ignored. Also, if sig is SIGCLD , the 
calling process's child processes will not create zombie 
processes when they terminate; see exit (2). 


function address - catch signal 

lf the signal is SIGPWR , the action to be taken is the 
same as that described above for func equal to function 
address . The same is true if the signal is SIGCLD 
except, that while the process is executing the signal- 
catching function, any received SIGCLD signals will be 
queued and the signal-catching function will be continu- 
ally reentered until the queue is empty. 
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The SIGCLD affects two other system calls ( wait. ine and exit 
(2)) in the following ways: : —_ 


wait lf the func value of SIGCLD is set to SIG_IGN and a a 
is executed, the wait will block until all of the calling 
process's child processes terminate; it will then return a 
value of —1 with errno set to ECHILD. 


exit If in the exiting process's parent process the func value 
of SIGCLD is set to SIG_IGN, the exiting process will not 
create a zombie process. 


When processing a pipeline, the shell makes the last process in 
the pipeline the parent of the proceeding processes. A process 
that may be piped into in this manner (and thus become the 
parent of other processes) should take care not to set SIGCLD to 
be caught. 
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stat, fstat — get file status 


#include <sys/types.h> 
#include <sys/stat.h> 


int stat (path, buf) 
char *path; 
struct stat +buf; 


int fstat (fildes, buf) 
int fildes; 
struct stat +buf; 


DESCRIPTION 
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Path points to a path name naming a file. Read, write, or execute 
permission of the named file is not required, but all directories listed 
in the path name leading to the file must be searchable. Stat 
obtains information about the named file. 


Similarly, fstat obtains information about an open file known by the 
file descriptor fildes, obtained from a successful open, creat, dup, 
fentl, or pipe system call. | 


Buf is a pointer to a stat structure into which information is placed 
concerning the file. 


The contents of the structure pointed to by buf include the following 


members: 


ushort st_mode; /x File mode; see mknod (2) */ 
ino_t st_ino; /* inode number */ 
dev_t = st_dev; /« ID of device containing */ 

/* a directory entry for this file */ 
dev_t __ st_rdev; /* 1D of device «/ 

/x This entry is defined only for */ 

/* character special or block special 
files */ 
short _—_ st_niink; /* Number of links */ 
ushort = st_uid; /* User ID of the file’s owner */ 
ushort — st_gid; /*« Group ID of the file’s group */ 
off_t st_size; /* File size in bytes */ 
time_t st_atime; /* Time of last access */ 
time_t st_mtime;  /* Time of last data modification «/ 
time_t st_ctime; /* Time of last file status change */ 

/* Times measured in seconds since 
2 / 


/* 00:00:00 GMT, Jan. 1, 1970 «/ 
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st_mtime 


st_ctime 
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Time when file data was last accessed. Changed by the 
following system calls: creat(2), mknod(2), pipe(2),“ > 
utime(2), and read(2). Sw 


Time when data was last modified. Changed by the fol- 
lowing system calls: creat(2), mknod(2), pipe(2), 
utime(2), and write(2). 


Time when file status was last changed. Changed by 
the following system calls: chmod(2), chown(2), 
creat(2), link(2), mknod(2), pipe(2), ners ), utime(2), 
and write(2). 


Stat will fail if one or more of the following are true: 


[ENOTDIR] A component of the path prefix is not a directory. 
[ENOENT] The named file does not exist. 
[EACCES] Search permission is denied for a component of 
the path prefix. 
[EFAULT] Buf or path points to an invalid address. 
Fstat will fail if one or more of the following are true: 
[EBADF] Fildes is not a valid open file descriptor. | 
[EFAULT] Buf points to an invalid address. : 
ye 
RETURN VALUE 
Upon successful completion a value of 0 is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the error. 
SEE ALSO 
chmod(2), chown(2), creat(2), link(2), mknod(2), pipe(2), read(2), 
time(2), unlink(2), utime(2), write(2). 
a 


August 19, 1986 


Page 2 


STIME (2) | UNIX Sys5 STIME(2) 


NAME 
stime — set time 


SYNOPSIS 
int stime (tp) 
long tp; 
DESCRIPTION 
Stime sets the system's idea of the time and date. Tp points to the 


value of time as measured in seconds from 00:00:00 GMT January 
1, 1970. 


[EPERM] Stime will fail if the effective user ID of the calling 
process is not super-user. 


RETURN VALUE 
Upon successful completion, a value of 0 is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the error. 


SEE ALSO 
time(2). 


Page 1 May 7, 1986 


SYNC(2) UNIX Sys5 -SYNC(2) 


NAME a 
sync — update super-block | ( ie 

SYNOPSIS ip eee 
void sync ( ) 

DESCRIPTION 


Sync causes all information in memory that should be on disk to be 
written out. This includes modified super blocks, modified i-nodes, 
and delayed block 1/O. | 


It should be used by programs which examine a file system, for 
example fsck , df, etc. It is mandatory before a boot. 


The writing, although scheduled, is not necessarily complete upon 
return from sync . | 
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NAME 
time — get time 
SYNOPSIS 
long time ((long *) 0) 
long time (tloc) 
long +tloc; 


DESCRIPTION 
Time returns the value of time in seconds since 00:00:00 GMT, 
January 1, 1970. 


If tloc (taken as an integer) is non-zero, the return value is also 
stored in the location to which floc points. 


[EFAULT] Time will fail if tloc points to an illegal address. 


RETURN VALUE 
Upon successful completion, time returns the value of time. Other- 
wise, a value of —1 is returned and errno is set to indicate the error. 


SEE ALSO 
stime(2). 
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NAME 
times — get process and child process times je 


SYNOPSIS Ne 
#include <sys/types.h> 
#include <sys/times.h> 


long times (buffer) 
struct tms «buffer; 


DESCRIPTION 
Times fills the structure pointed to by buffer with time-accounting 
information. The following are the contents of this structure: 


struct tms { 

time_t tms_utime; 

time_t tms_stime; 

time_t tms_cutime; 

time_t tms_cstime; 
} 
This information comes from the calling process and each of its ter- 
minated child processes for which it has executed a wait . All times 
are in 64ths of a second. 


Tms_utime is the CPU time used while executing instructions in the 
user space of the calling process. 


Tms_stime is the CPU time used by the system on behalf of the cal- 
ling process. 


Tms_cutime is the sum of the tms_utime s and tms_cutime s of the 
child processes. 


Tms_cstime: is the sum of the tms_stime s and tms_cstime s of the 
child processes. 


[EFAULT] Jimes will fail if buffer points to an illegal address. 


RETURN VALUE 
Upon successful completion, times returns the elapsed real time, in 
64ths of a second, since an arbitrary point in the past (e.g., system 
start-up time). This point does not change from one invocation of 
times to another. lf times fails, a —1 is returned and errno is set to 
indicate the error. 


SEE ALSO 
exec(2), fork(2), time(2), wait(2). | 
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NAME 
Eee ulimit — get and set user limits 
\_ SYNOPSIS 
long ulimit (cmd, newlimit) 
— int cmd; 
long newlimit; 
DESCRIPTION 


This function provides for control over process limits. The cmd 
values available are: 


1 Get the file size limit of the process. The limit is in units of 
512-byte blocks and is inherited by child processes. Files of 
any size can be read. 


2 Set the file size limit of the process to the value of newlimit . 
Any process may decrease this limit, but only a process with 
an effective user ID of super-user may increase the limit. 
Ulimit will fail and the limit will be unchanged if a process with 
an effective user ID other than super-user attempts to increase 
its file size limit. [EPERM] 


3 Get the maximum possible break value. See brk (2). 


_.. RETURN VALUE 

—_ Upon successful completion, a non-negative value is returned. Oth- 

a ~ erwise, a value of —1 is returned and errno is set to indicate the 
error. 


SEE ALSO 
brk(2), write(2). 
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NAME 
umask — set and get file creation mask _ a 
SYNOPSIS NS 
int umask (cmask) 
int cmask; 
DESCRIPTION 


Umask sets the process's file mode creation mask to cmask and 
returns the previous value of the mask. Only the low-order 9 bits of 
cmask and the file mode creation mask are used. 


RETURN VALUE | 
The previous value of the file mode creation mask is returned. 


SEE ALSO 
chmod(2), creat(2), mknod(2), open(2). 
mkdir(1), sh(1) in the Sys5 UNIX User Reference Manual. 
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uname — get name of current UNIX system 


SYNOPSIS 
#include <sys‘utsname.h> 


int uname (name) 
struct utsname «name; 


DESCRIPTION 
Uname stores information identifying the current UNIX system in the 
structure pointed to by name . 


Uname uses the structure defined in <sys/utsname.h> whose 


members are: 


char 
char 
char 
char 
char 


sysname[9]; 
nodename{9]; 
release[9]; 
version(9]; 
machine[9]; 


Uname returns a null-terminated character string naming the current 
UNIX system in the character array sysname . Similarly, nodename 
contains the name that the system is known by on a communica- 
tions network. Release and version further identify the operating 
system. Machine contains a standard name that identifies the 
hardware that the UNIX system is running on. 


[EFAULT] Uname will fail if name points to an invalid address. 


RETURN VALUE 
Upon successful completion, a non-negative value is returned. Oth- 
erwise, —1 is returned and errno is set to indicate the error. 


SEE ALSO 
uname(1) in the Sys5 UNIX User Reference Manual. 
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NAME - 
unlink — remove directory entry | (— ‘ 


SYNOPSIS - 
int unlink (path) 
char *path; 


DESCRIPTION 
Unlink removes the directory entry named by the path name pointed 
to be path. 


The named file is unlinked unless one or more of the following are 
true: 


[ENOTDIR] A component of the path prefix is not a directory. 
[ENOENT] The named file does not exist. 


[EACCES] Search permission is denied for a component of 
the path prefix. 


[EACCES] Write permission is denied on the directory contain- 
ing the link to be removed. 


[(EPERM] The named file is a directory and the effective user 
ID of the process is not super-user. 


[EBUSY] The entry to be unlinked is the mount point fora’ > 
mounted file system. he 


[ETXTBSY] The entry to be unlinked is the last link to a pure 
procedure (shared text) file that is being executed. 


[EROFS] The directory entry to be unlinked is part of a 
read-only file system. 


[EFAULT] | Path points outside the process's allocated 
address space. 


When all links to a file have been removed and no process has the 
file open, the space occupied by the file is freed and the file ceases 
to exist. If one or more processes have the file open when the last 
link is removed, the removal is postponed until all references to the 
file have been closed. 


RETURN VALUE 
Upon successful completion, a value of 0 is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the error. 


SEE ALSO 
close(2), link(2), open(2). 
rm(1) in the Sys5 UNIX User Reference Manual. —_ 
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NAME 
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ustat — get file system statistics 


SYNOPSIS 


#include <sys/types.h> 
#include <ustat.h> 


int ustat (dev, buf) 
int dev; 
struct ustat «buf; 


DESCRIPTION 


Ustat returns information about a mounted file system. Dev is a 
device number identifying a device containing a mounted file sys- 
tem. Buf is a pointer to a ustat structure that includes to following 


elements: 
daddr_t f_tfree; /* Total free blocks «/ 
ino_t f_tinode; /* Number of free inodes */ 
char f_fname[6]; /« Filsys name */ 
char f_fpack[6]; /* Filsys pack name */ 
Ustat will fail if one or more of the following are true: 
[EINVAL] Dev is not the device number of a device contain- 
ing a mounted file system. 
[EFAULT] Buf points outside the process's allocated address 
space. 


RETURN VALUE 
Upon successful completion, a value of 0 is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the error. 


SEE ALSO 


stat(2), fs(4). 
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NAME 


utime — set file access and modification times 


SYNOPSIS 


#include <sys/types.h> 
int utime (path, times) 
char *path; 

struct utimbuf *times; 


DESCRIPTION 
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Path points to a path name naming a file. Utime sets the access 
and modification times of the named file. 


If times is NULL , the access and modification times of the file are 
set to the current time. A process must be the owner of the file or 
have write permission to use utime in this manner. 


If times is not NULL, times is interpreted as a pointer to a utimbuf 
structure and the access and modification times are set to the 
values contained in the designated structure. Only the owner of the 
file or the super-user may use utime this way. 


The times in the following structure are measured in seconds since 
00:00:00 GMT, Jan. 1, 1970. 


struct utimbuf { 
time_t actime; /s access time «/ 
time_t modtime; /* modification time «/ 


if 

Utime will fail if one or more of the following are true: 

[ENOENT] The named file does not exist. 

[ENOTDIR] - A component of the path prefix is not a directory. 

[EACCES] Search permission is denied by a component of the 
path prefix. 

[EPERM] The effective user ID is not super-user and not the 
owner of the file and times is not NULL . 

[EACCES] The effective user ID is not super-user and not the 
owner of the file and times is NULL and write 
access is denied. 

[EROFS] The file system containing the file is mounted 
read-only. 

[EFAULT] Times is not NULL and points outside the process's 
allocated address space. 

[EFAULT] _ Path points outside the process's allocated| 


address space. 
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RETURN VALUE 
Upon successful completion, a value of 0 is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the error. 


SEE ALSO. 
stat(2). 
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NAME 
wait — wait for child process to stop or terminate — 


SYNOPSIS No 
int wait (stat_loc) ee 3 
int *stat_loc; 


int wait ((int *)0) 


DESCRIPTION | 
Wait suspends the calling process until one of the immediate chil- 
dren terminates or until a child that is being traced stops, because it 
has hit a break point. The wait system call will return prematurely if 
a signal is received and if a child process stopped or terminated 
prior to the call on wait , return is immediate. 


If stat_loc (taken as an integer) is non-zero, 16 bits of information 
called status are stored in the low order 16 bits of the location 
pointed to by stat_foc . Status can be used to differentiate between 
stopped and terminated child processes and if the child process ter- 
minated, status identifies the cause of termination and passes use- 
ful information to the parent. This is accomplished in the following 
manner: 


If the child process stopped, the high order 8 bits of status 
will contain the number of the signal that caused the pro- | 
cess to stop and the low order 8 bits will be set equal to 
0177. 


lf the child process terminated due to an exit call, the low 
order 8 bits of status will be zero and the high order 8 bits 
will contain the low order 8 bits of the argument that the 
child process passed to exit ; see exit (2). 


If the child process terminated due to a signal, the high 
order 8 bits of status will be zero and the low order 8 bits 
will contain the number of the signal that caused the termi- 
nation. In addition, if the low order seventh bit (i.e., bit 200) 
is set, a “core image” will have been produced; see signal 


(2). 
lf a parent process terminates without waiting for its child processes 
to terminate, the parent process ID of each child process is set to 1. 
This means the initialization process inherits the child processes; 
see intro (2). 


Wait will fail and return immediately if one or more of the following 
are true: 


[ECHILD] The calling process has no existing unwaited-for ( 


es 
child processes. | 7 
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[EFAULT] Stat_loc points to an illegal address. 


RETURN VALUE 
If wait returns due to the receipt of a signal, a value of —1 is 
returned to the calling process and errno is set to EINTR. If wait 
returns due to a stopped or terminated child process, the process ID 
of the child is returned to the calling process. Otherwise, a value of 
—1 is returned and errno is set to indicate the error. 


SEE ALSO 
exec(2), exit(2), fork(2), intro(2), pause(2), ptrace(2), signal(2). 


WARNING 
See WARNING in signal (2). 
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NAME 
write — write on a file : 3 —_ 


SYNOPSIS ee 
int write (fildes, buf, nbyte) | 
int fildes; 
char *buf; 
unsigned nbyte; 


DESCRIPTION | 
Fildes is a file descriptor obtained from a creat , open , dup, fcnitl, 
or pipe system call. 


Write attempts to write nbyte bytes from the buffer pointed to by buf 
to the file associated with the fildes . 


On devices capable of seeking, the actual writing of data proceeds 

from the position in the file indicated by the file pointer. Upon return 
from write , the file pointer is incremented by the number of bytes 
actually written. 


On devices incapable of seeking, writing always takes place starting 
at the current position. The value of a file pointer associated with 
such a device is undefined. 


If the O_APPEND flag of the file status flags is set, the file pointer will 
be set to the end of the file prior to each write. 


Write will fail and the file pointer will remain unchanged if one or 
more of the following are true: 


[EBADF] Fildes is not a valid file descriptor open for writing. 


[EPIPE and SIGPIPE signal] 
An attempt is made to write to a pipe that is not 
open for reading by any process. 


[EFBIG] An attempt was made to write a file that exceeds 
the process's file size limit or the maximum file 
size. See ulimit (2). 


[EFAULT] Buf points outside the process's allocated address 
space. 
[EINTR] A signal was caught during the write system call. 


lf a write requests that more bytes be written than there is room for 
(e.g., the ulimit (see ulimit (2)) or the physical end of a medium), 
only as many bytes as there is room for will be written. For exam- 
ple, suppose there is space for 20 bytes more in a file before reach- 
ing a limit. A write of 512 bytes will return 20. The next writeofa «~~ 


\ J 
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non-zero number of bytes will give a failure return (except as noted 
below). 


If the file being written is a pipe (or FIFO) and the O_NDELAY flag of 
the file flag word is set, then write to a full pipe (or FIFO) will return a 
count of 0. Otherwise (O._NDELAY clear), writes to a full pipe (or 
FIFO) will block until space becomes available. 


RETURN VALUE | 
Upon successful completion the number of bytes actually written is 
returned. Otherwise, —1 is returned and errno is set to indicate the 
error. 


SEE ALSO 
creat(2), dup(2), lseek(2), open(2), pipe(2), ulimit(2). 
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NAME 
intro — introduction to standalone system calls, functions, and error 
numbers 


SYNOPSIS 
#include <errno.h> 


DESCRIPTION 
This section describes the system calls and functions provided in 
the standalone archive //ib/lib2.a. Most of these calls have one or 
more error returns. An error condition is indicated by an otherwise 
impossible returned value. This is almost always —1; the individual 
descriptions specify the details. An error number is also made avail- 
able in the external variable errno. Errno is not cleared on success- 
ful calls, so it should be tested only after an error has been indi- 
cated. 


Each standalone call description attempts to list all possible error 
numbers. The following is a complete list of all possible error 
numbers returned by standalone system calls and functions, with 
their names as described in <errno.h>. 


1 EPERM Not owner 
Typically this error indicates an attempt to modify a file in 
some way. Disk files cannot be modified while in standalone 
mode. 


2 ENOENT No such file or directory 
This error occurs when a file name is specified and the file 
should exist but doesn't, or when one of the directories in a 
path name does not exist. 


5 ElO VO error 
Some physical |/O error has occurred. This error may in 
some cases occur on a call following the one to which it 
actually applies. 


6 ENXIO No such device or address 
/O on a special file refers to a subdevice which does not 
exist, or beyond the limits of the device. It may also occur 
when, for example, a tape drive is not on-line. 


9 EBADF Bad file number 
Either a file descriptor refers to no open file, or a read 
(respectively, write) request is made to a file which is open 
only for writing (respectively, reading). 


13 EACCES Permission denied 
An attempt was made to access a file in a way forbidden by 
the protection system. 
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16 EBUSY Device or resource busy 
An attempt was made to mount a device that was sieaay _ 
mounted or an attempt was made to dismount a device on \ 
which there is an active file (open file, current directory, — 
mounted-on file, active text segment), or the device or 
resource is currently unavailable. 


17 EEXIST File exists 
An existing file was mentioned in an inappropriate context, 
e.g., mknod. 


19 ENODEV No such device 
An attempt was made to apply an inappropriate system call 
to a device; e.g., read a write-only device. 


20 ENOTDIR Not a directory 
A non-directory was specified where a directory is required, 
for example in a path prefix or as an argument to chdir (2). 


22 EINVAL Invalid argument 
Some invalid argument (e.g., dismounting a non- -mounted 
device or reading or writing a file for which /seek has gen- 
erated a negative pointer). 


24 EMFILE Too many open files 
No process may have more than 20 file descriptors open at ” | 
a time. Se it 


25 ENOTTY Not a character device 
An attempt was made to /octl(2) a file that is not a special 
character device. 


27 EFBIG File too large 
The size of a file exceeded the maximum file size 
(1,082,201,088 bytes). 


DEFINITIONS 
See intro(2) for a complete set of definitions. 


DEVICES 
A limited number of device awe are available for use with stand- 
alone programs. These are the disk driver, the reel-to-reel and car- 
tridge tape drivers, the floppy disk driver (P/15 and P/20 only) and 
the null device. The names used to refer to these devices are 
shown in Table 2.1. 
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Table 2-1. 


/dev/dsk/#s# disk drive, blocked |/O 

/dev/rrm/Om reel-to-reel tape, raw I/O, rewind on close 
/dev/rrm/Omn _ reel-to-reel tape, raw I/O, no rewind on close 
jaeuicnlon reel-to-reel tape, blocked I/O, rewind on close 
/dev/rm0 reel-to-reel tape, blocked I/O, rewind on close 


/dev/rm/Omn reel-to-reel tape, blocked I/O, no rewind on close 


/dev/nrmO reel-to-reel tpae, blocked I/O, no rewind on close 
/dev/rpt/Om cartridge tape, blocked |/O, rewind on close 
/dev/rptO cartridge tape, blocked 1/O, rewind on close 


/dev/rtp/Omn cartridge tape, blocked I/O, no rewind on close 
/dev/nrptO cartridge tape, blocked I/O, no rewind on close 
/dev/fp/Om floppy disk (P/15 and P/20 only) 


/dev/null the null device 
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NAME 

access — determine accessibility of a file 
SYNOPSIS 

int access (path, amode) 

char +path; 

int amode; 
DESCRIPTION 


ACCESS(2S) 


Path points to a path name naming a file. Access checks the 
named file for accessibility according to the bit pattern contained in 
amode. The bit pattern contained in amode is constructed as fol- 


lows: 
04 read 
02 write 
01 execute (search) 
00 check existence of file . 


Access will fail if one of the following is true: 


[EINVAL] The file is not available for reading. 


[ENOTDIR] A component of the path prefix is not a directory. 


[ENOENT] The named file does not exist. 


[EMFILE] Twenty (20) file descriptors are currently open. 
[EACCES] __ The file cannot be used in the specified mode. 


RETURN VALUE 
If the requested access is permitted, a value of 0 is returned. Oth- 
erwise, a value of —1 is returned and errno is set to indicate the 


error. 


SEE ALSO 
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open(2S), stat(2S). 
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NAME 

brk, sork — change data segment space allocation 
SYNOPSIS 

int brk (endds) 

char *endds; 

char *sbrk (incr) 

int incr; 
DESCRIPTION 


Brk and sbrk are used to change dynamically the amount of space 
allocated for the calling process's data segment. The change is 
made by resetting the process's break value and allocating the 
appropriate amount of space. The break value is the address of the 
first location beyond the end of the data segment. The amount of 
allocated space increases as the break value increases. The newly 
allocated space is set to zero. 


Brk sets the break value to endds and changes the allocated space 
accordingly. 


Sbrk adds incr bytes to the break value and changes the allocated 
space accordingly. /ncr can be negative, in which case the amount 
of allocated space is decreased. 


( RETURN VALUE 
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Brk returns a value of O hana sbrk returns the old break value. 
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NAME | 
chdir — change working directory —_ 

SYNOPSIS ? an eat 
int chdir (path) 
char +path; 

DESCRIPTION 


Path points to the path name of a directory. Chdir causes the 
named directory to become the current working directory, the start- 
ing point for path searches for path names not beginning with /. 


RETURN VALUE 
A value of 0 is returned. 


ae = 
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NAME 
chmod — change mode of file 


~ SYNOPSIS 
int chmod ( ) 


DESCRIPTION | 
This is a dummy routine and always returns a -1 with the error: 


[EPERM] The file cannot be modified by standalone process. 
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NAME 
close—closeafiledescriptor = #8 —_ 
SYNOPSIS | re 
int close (fildes) | 
int fildes; 
DESCRIPTION 


Fildes is a file descriptor obtained from a creat or open standalone 
system call. Close closes the file descriptor indicated by fildes . 


[EBADF] 
Close will fail with errno set to [EBADF] if fildes is not a 
valid open file descriptor. 


RETURN VALUE 
Upon successful completion, a value of 0 is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the error. 


SEE ALSO 
creat(2S), open(2S). 
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NAME 
( | creat — create a new special file 
SYNOPSIS 
int creat (path) 
char *path; 
DESCRIPTION 
Creat creates a new device file. 
Upon successful completion, the file descriptor is returned and the 
file is open for writing, even if the mode does not permit writing. 
The file pointer is set to the beginning of the file. No process may 
have more than 20 files open simultaneously. A new file may be 
created with a mode that forbids writing. 
Creat will fail if one or more of the following are true: 
[ENOTDIR] A component of the path prefix is not a directory. 
[ENOENT] A component of the path prefix does not exist. 
[EACCES] _ Search permission is denied on a component of the 
path prefix. 

[ENOENT] The path name is null. 

ae [ENOENT] The special file is not one available in standalone 

( mode. 

[EACCES] The file is not a special device file. 
[EMFILE] Twenty (20) file descriptors are currently open. 


RETURN VALUE 
Upon successful completion, a non-negative integer, namely the file 
descriptor, is returned. Otherwise, a value of —1 is returned and 
errno is set to indicate the error. 


SEE ALSO 
close(2S), intro(2S), lseek(2S), open(2S), read(2S), umask(2S), 
write(2S). 
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NAME _ 
exit — terminate process | 7 aa 


SYNOPSIS _ ey ee ad 
void exit (status) 
int status; 


DESCRIPTION : 
Exit terminates the calling process, displaying "EXIT <status>" and 
_ Closing all file descriptors open in the calling process. 
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NAME 
aan fltused, uufp, femp, comfloa, fadd, fsub, fmul, fdiv, dneg, fneg, ftod, 
| | dtof, afadd, afsub, afmul, afdiv, afaddf, afsubf, afmulf, afdivf, softfp, 
convert, conv, itod, dtoi, itof, ftoi. — float and double routines 


DESCRIPTION 
These are all dummy routines which merely return. They are pro- 
vided to enable compilation of programs, but any program which 
uses these routines can be expected to fail. You cannot, then, do 
any mathematics involving floats or doubles, you cannot convert 
from floats to doubles or integers or vice versa in any combination, 
and you cannot print floating point numbers. 
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— getargv — display a program name and get arguments for it _ 
SYNOPSIS Ly 
int getargy (cmd, argvp, ff) 
char *cmd; 
char *(*argvp[ ]); 
int ff; 
DESCRIPTION 


Getargv displays the name of a standalone program on stdout in the 
form "$$ < cmd >" and waits for arguments to be provided from 
stdin. 


lf ff has a value greater than 0, the argument buffer argvp is first 
cleared. Arguments are assumed to be separated by blanks or 
tabs, and input is terminated by entry of a carriage return (\n). 
Arguments are put into the buffer in the order received, with the first 
(index 0) argument being cmd. 


RETURN VALUE 
A zero is returned. 


a. 
bee _ 
4 ‘ 
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NAME 
( - getpid — get process ID 
SYNOPSIS 
int getpid () 
DESCRIPTION 


This is a dummy routine. It returns 0, which is the appropriate value 
in standalone mode. 
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NAME 
getuid, geteuid, getgid, getegid — get real user, effective user, real ~ 
group, and effective group IDs | LY 


ee 
SYNOPSIS 
unsigned short getuid () 


unsigned short geteuid () 
unsigned short getgid () 
unsigned short getegid () 


DESCRIPTION 
These are dummy routines. All return 0, which is the appropriate 
value in standalone mode. 
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gtty — get terminal characterisitcs 


SYNOPSIS 

int gtty (fildes, buf) 
int fildes; 

struct sgttyb “buf; 


DESCRIPTION 
Gtty gets the terminal characteristics of the device specified by 
fildes. Fildes must have a value of 0, 1, or 2. An error [ENOTTY] is 
returned if it does not. 


The buffer buf has the form: 


struct sgttyb { 


char sg _ispeed; /“input speed”*/ 
char sg __ospeed; /*‘output speed*/ 
char sg _erase; /“erase character*/ 
char sg _kill; /“kill character*/ 
int sg _flags; /“mode flags*/ 

j 


Mode flags which are supported are: 

RAW (040) Handle input in raw mode. 

LCASE (04) Map upper case input to lower case. 
XTABS (02) Expand tabs to 7 spaces. 

ECHO (010) Echo input received from stdin to stdout. 
CRMOD (020) Map newline to newline/carriage return. 
Input and output speeds are as described in tty(7). 


RETURN VALUE 
Upon successful completion, a 0 is returned. Otherwise, a -1 is 
returned and errno is set to [ENOTTY]. 


SEE ALSO 
stty(2S), tty(7). 
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NAME 
isatty — returns a 1 if specified file descriptor is a terminal 


SYNOPSIS 
int isatty (fildes) 


int fildes; 


DESCRIPTION 
If fildes is stdin, stdout or stderr (0, 1, or 2), isatty returns a1. Oth- 
erwise aQis returned. 
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NAME 
kill — send a signal to a process or a group of processes 


_ SYNOPSIS 


int kill () 


DESCRIPTION | 
This is a dummy routine. It always returns a 0. 
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NAME 


lseek — move read/write file pointer — 


SYNOPSIS 


long Iseek (fildes, offset, whence) 
int fildes; 

long offset; 

int whence; 


DESCRIPTION 


Fildes is a file descriptor returned from a creat or open standalone 
system call. Lseek sets the file pointer associated with fildes as fol- 
lows: 
If whence is 0, the pointer is set to offset bytes. 
If whence is 1, the pointer is set to its current location plus 
Offset . 
If whence is 2, the pointer is set to the size of the file plus 
offset . 


Upon successful completion, the resulting pointer location, as meas- 
ured in bytes from the beginning of the file, is returned. 


Lseek will fail and the file pointer will remain unchanged if one or 
more of the following are true: 


[EBADF] Fildes is not an open file descriptor. 
[EINVAL] Whence is not 0, 1, or 2. 
[EINVAL] The resulting file pointer would be negative. 


Some devices are incapable of seeking. The value of the file 
pointer associated with such a device is undefined. 


RETURN VALUE 


Upon successful completion, a non-negative integer indicating the 
file pointer value is returned. Otherwise, a value of —1 is returned 
and errno is set to indicate the error. 


SEE ALSO 
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creat(2S), open(2S), tell(2S) 
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NAME 
mknod — make a special file 


SYNOPSIS 
#include stand.h 
int mknod (path, major, minor, offset) 
char +path; : 
int major, minor; 
daddr_t offset; 


DESCRIPTION 
Mknod defines a new device file named by the path name pointed 
to by path. 


The strategy which will be used is determined by the device table 
entry indexed by major. The physical unit number is determined by 
minor. The default beginning access offset is defined by offset. 


Mknod will fail, the new device name will not be defined, and errno 
will be set to one of the following values if one or more of the follow- 
ing conditions is true: 


[EINVAL] Major is not a valid index into the device table, or any of 
the parameters are less than 0. 


(EEXIST] The special file name has already been defined. 


Mknod will also fail if the maximum number of special files has 
already been defined. An error message will be displayed in this 
case. 


RETURN VALUE 
Upon successful completion, a value of 0 is returned. Otherwise, a 
value of -1 is returned and errno is set to indicate the error. 
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NAME m 
mount — mount a file system | —_ 


SYNOPSIS a, 
int mount (spec, dir) | 
char *spec, *dir; ‘ 

DESCRIPTION 
Mount requests that a removable file system contained on the block 


special file identified by spec be mounted on the directory identified 
by dir. Spec and dir are pointers to path names. 


Upon successful completion, references to the file dir will refer to 
the root directory on the mounted file system. 


Mount will fail if one or more of the following are true: 


[ENODEV] Spec is not a device available for use in stand- 
alone mode. 

[EINVAL] Dir is not available for use in standalone mode. 

[ENXIO}] The device associated with spec does not exist. 

[ENOTDIR] Dir is not a directory. 

[EBUSY] The device associated with spec is currently 
mounted. a 

[EBUSY] There are no more mount table entries. Re ge 


RETURN VALUE 
Upon successful completion a value of 0 is returned. Otherwise, a 
value of -1 is returned and errno is set to indicate the error. 


SEE ALSO 
umount(2S).. 
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NAME 

nice — change priority of a process 
SYNOPSIS 

int nice ( ) 


DESCRIPTION | 
This is a dummy routine provided for compilation compatibility. Nice 
always returns a value of 0. 
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NAME 


open — open for reading or writing 


SYNOPSIS 


int open (path, oflag) 
char +path; 
int oflag; 


DESCRIPTION 


Path points to a path name naming a file. Open opens a file 
descriptor for the named file and sets the file status flags according 
to the value of oflag, defined as shown: 


0 Open for reading only. 
1 Open for writing only. 
2 Open for reading and writing. 


The file pointer used to mark the current position within the file is set 
to the beginning of the file. 


The named file is opened unless one or more of the following are 
true: 


[EINVAL] Mode is not valid. 

[EACCES] Mode is 1 or 2 and the file is not a special file (dev- ~ _ 
ice). . 

[ENOTDIR] A component of the path prefix is not a directory. 

[ENOENT] The named file does not exist, or the path name is 
null. 

[EMFILE] = —“ Twenty (20) file descriptors are currently open. 


RETURN VALUE 


Upon successful completion, the file descriptor is returned. Other- 
wise, a value of —1 is returned and errno is set to indicate the error. 


SEE ALSO 
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close(2S), creat(2S), Ilseek(2S), read(2S), umask(2S), write(2S). 
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NAME 


read — read from file 


SYNOPSIS 


int read (fildes, buf, nbyte) 
int fildes; 

char +buf; 

unsigned nbyte; 


DESCRIPTION 


Fildes is a file descriptor obtained from a creat or open standalone 
system call. 


Read attempts to read nbyte bytes from the file associated with 
fildes into the buffer pointed to by buf . 


On devices capable of seeking, the read starts at a position in the 
file given by the file pointer associated with fildes . Upon return from 
read , the file pointer is incremented by the number of bytes actually 
read. 


Devices that are incapable of seeking always read from the current 
position. The value of a file pointer associated with such a file is 
undefined. 


Upon successful completion, read returns the number of bytes actu- 
ally read and placed in the buffer; this number may be less than 
nbyte if the file is associated with a communication line or if the 
number of bytes left in the file is less than nbyte bytes. A value of 0 
is returned when an end-of-file has been reached. 


Read will fail if the following is true: 
[EBADF] Fildes is not a valid file descriptor open for reading. 


RETURN VALUE 


Upon successful completion a non-negative integer is returned indi- 
cating the number of bytes actually read. Otherwise, a —1 is 
returned and errno is set to indicate the error. 


SEE ALSO 
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creat(2S), open(2S). 
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NAME 
sleep — suspend execution for interval 


SYNOPSIS 
int sleep (seconds) 
int seconds; 


DESCRIPTION 
The current process is suspended from execution for the number of 
seconds specified by the argument. The actual suspension time will 
be less than that requested if any character is read from stdin. The 
value returned by s/eep will be the “unslept” amount (the requested 
time minus the time actually slept). 
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NAME 


srcheof — position to a specific file number on a tape. 


SYNOPSIS 


srcheof (fdesc, count) 
int fdesc, count; 


DESCRIPTION 


Srcheof will advance a tape drive specified by the file descriptor 
fdesc to the start of the file number indicated by count. 


Srcheof will fail, returning a -1 with errno set appropriately if one of 
the following conditions is true: 


_[EBADF] fdesc does not indicate a valid open file 


[EBADF] fdesc does not indicate a tape device 


RETURN VALUE 


Upon successful completion, a value of 0 is returned. Otherwise, a 
value of -1 will be returned with errno set appropriately, or if there 
has been a hardware problem detected by the tape controller, the 
error status value is returned. These values are defined in the tape 
controller header files. These files are /usr/include/sys/imsc.h for 
the cartridge tape, and /usr/include/sys/rm.h for the reel-to-reel 
tape. 


_ SEE ALSO 
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open(2S), creat(2S) 


October 13, 1986 


STAT(2S) (Plexus) STAT(2S) 


NAME 
stat, fstat — get file status 7 voy 


SYNOPSIS f 8 Saw 
int stat (path, buf) 
char +path; 
struct stat +*buf; 


int fstat (fildes, buf) 
int fildes; 
struct stat +buf; 


DESCRIPTION | 
Path points to a path name naming a file. Read, write, or execute 
permission of the named file is not required, but all directories listed 
in the path name leading to the file must be searchable. Stat 
obtains information about the named file. , 


Similarly, fstat obtains information about an open file known by the 
file descriptor fildes , obtained from a successful open or creat sys- 
tem call. 


Buf is a pointer to a stat structure into which information is placed 
concerning the file. 


The contents of the structure pointed to by buf include the following a 


members: a y 
ushort st_mode;  /*« File mode; see mknod (2) */ * 
ino_t — st_ino; /* node number #/ 
dev_t = st_dev; /* ID of device containing */ 

/* a directory entry for this file «/ 
dev_t_ st_rdev; /* ID of device +/ 

/* This entry is defined only for */ 

/* character special or block special 
files */ 
short — st_nlink; /* Number of links */ 
ushort — st_uid; /* User ID of the file’s owner */ 
ushort — st_gid; /* Group ID of the file’s group «/ 
off_t st_size; /* File size in bytes */ 


time_t  st_atime; /*x Time of last access */ 
time_t st_mtime; /*x Time of last data modification «/ 
time_t st_ctime; /*« Time of last file status change */ 

/*« Times measured in seconds since 
x / 

/* 00:00:00 GMT, Jan. 1, 1970 «/ 


st_atime Time when file data was last accessed. This will not be ,—~ 
changed by any standalone system call. a 


st_mtime Time when data was last modified. Not altered in stan- 
dalone mode. 
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st_ctime Time when file status was last changed. 


Stat will fail if one or more of the following are true: 


[ENOTDIRA] A component of the path prefix is not a directory. 
[ENOENT] The named file does not exist. 
[EACCES] Search permission is denied for a component of 


the path prefix. 
Fstat will fail if the following is true: 
[EBADF] Fildes is not a valid open file descriptor. 


RETURN VALUE 
Upon successful completion a value of 0 is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the error. 
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NAME ; 
stime — set time aan 
i we 
SYNOPSIS | 7 
int stime (tp) 
long +tp; 


DESCRIPTION 
Stime sets the system's idea of the time and date. Tp points to the 
value of time as measured in seconds from 00:00:00 GMT January 
1, 1970. 


SEE ALSO 
time(2S). 


a, 
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_ NAME 
-_ stty — set terminal characteristics 


SYNOPSIS 
int stty (fildes, buf) 
int fildes; 
struct sgttyb buf; 


DESCRIPTION 
Stty sets the terminal characteristics of the device specified by fildes 
to the value indicated in the struct “buf. Fildes must have a value of 
0,1, or 2. An error [ENOTTY] is returned if it does not. 


The buffer has the form: 


struct sgttyb { 


char Sg_ispeed; 
char Sg_ospeed; 
char sg_erase; 
char sg_kill; 

int sg_flags; 


Mode flags which are aupported are: 
RAW (040) Handle input in raw mode. 


LCASE (04) 
Map upper case input to lower case. 


XTABS (02) 
Expand tabs to 7 spaces. 


ECHO (010) 
Echo input received from stdin to stdout. 


CRMOD (020) 
Map newline to newline/carriage return. 


Input and output speeds are as described in tty(7). 


RETURN VALUE 
Upon successful completion, a 0 is returned. Otherwise, a —1 is 
returned and errno is set to [ENOTTY]. 


SEE ALSO 
gtty(2S), tty(7). 
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NAME 


tell — report the current value of a file pointer 


SYNOPSIS 


off_t tell (fildes) 
int fildes; 


DESCRIPTION 


Tell is a shorthand call to seek. It calls [seek for the deivce indi- 
cated by the file descriptor fildes with an offset of 0 and a "whence" 
parameter of 1 (see /seek(2s)). Tell will fail if one or more of the fol- 
lowing are true: 


[EBADF] Fildes is not an open file descriptor. 
[EINVAL] Whence is not 0, 1, or 2. 
[EINVAL] The resulting file pointer would be negative. 


RETURN VALUE 


Upon successful completion, a non-negative integer indicating the 
file pointer value is returned. Otherwise, a value of -1 is returned 
and errno is set to indicate the eroor. 


SEE ALSO 
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creat(2S), open(2S), lseek(2S). 
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NAME 
time — get time 
SYNOPSIS 
long time ((long *) 0) 
long time (tloc) 
long +*tloc; 


DESCRIPTION 
Time returns the value of time in seconds since 00:00:00 GMT, 
January 1, 1970. 


If tloc (taken as an integer) is non-zero, the return value is also 
stored in the location to which tloc points. 


RETURN VALUE 
Time returns the value of time. 


SEE ALSO 
stime(2S). 
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NAME 


umask — set and get file creation mask — 
SYNOPSIS oe 
int umask ( ) 
DESCRIPTION 
This is a dummy routine provided for compilation compatibility. It 
always returns 0. | 
a 7 = 
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NAME 
umount — unmount a file system 


SYNOPSIS 
int umount (spec) 
char *spec; 

DESCRIPTION 
Umount requests that a previously mounted file system contained 
on the block special device identified by spec be unmounted. Spec 
is a pointer to a path name. After unmounting the file system, the 
directory upon which the file system was mounted reverts to its ordi- 
nary interpretation. 


Umount will fail if the following is true: 
[EINVAL] The device specified is not mounted. 


RETURN VALUE 
Upon successful completion a value of 0 is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the error. 


SEE ALSO 
mount(2S). 


Page 1 October 13, 1986 


USTAT(2S) (Plexus) USTAT(2S) 


NAME 
ustat — get file system statistics 


SYNOPSIS 
int ustat (dev, buf) 
int dev; 
struct ustat «buf; 


DESCRIPTION 
Ustat returns information about a mounted file system. Dev is a 
device number identifying a device containing a mounted file sys- 
tem. Buf is a pointer to a ustat structure that includes to following 


elements: 
daddr_t f_tfree; /x Total free blocks */ 
ino_t f_tinode; /*« Number of free inodes */ 
char f_fname[6]; /* Filsys name */ 
char f_fpack[6]; /* Filsys pack name */- 


Ustat will fail if the following is true: 


[EINVAL] Dev is not the device number of a device contain- 
ing a mounted file system. 


RETURN VALUE 


Upon successful completion, a value of 0 is returned. Otherwise, a 


value of —1 is returned and errno is set to indicate the error. 


SEE ALSO 
stat(2S), fs(4). 
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_ NAME 


write — write on a file 


~ SYNOPSIS 


int write (fildes, buf, nbyte) 
int fildes; 
char +buf; 
int nbyte; 


DESCRIPTION 


Fildes is a file descriptor obtained from a creat or open standalone 
system call. 


Write attempts to write nbyte bytes from the buffer pointed to by buf 
to the file associated with the fildes . 


On devices capable of seeking, the actual writing of data proceeds 
from the position in the file indicated by the file pointer. Upon return 
from write , the file pointer is incremented by the number of bytes 
actually written. 


On devices incapable of seeking, writing always takes place starting 
at the current position. The value of a file pointer associated with 
such a device is undefined. 


Write will fail and the file pointer will remain unchanged if one or 
more of the following are true: 


[EBADF] Fildes is not a valid file descriptor open for writing. 


[EFBIG] An attempt was made to write a file that exceeds 
the process's file size limit or the maximum file — 
size. See ulimit (2). 


If a write requests that more bytes be written than there is room for 
only as many bytes as there is room for will be written. For exam- 
ple, suppose there is space for 20 bytes more in a file before reach- 
ing a limit. A write of 512 bytes will return 20. The next write of a 
non-zero number of bytes will give a failure return. 


RETURN VALUE 


Upon successful completion the number of bytes actually written is 
returned. Otherwise, —1 is returned and errno is set to indicate the 
error. 


SEE ALSO 
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creat(2S), Iseek(2S), open(2S). 
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NAME 


intro — introduction to subroutines and libraries 


SYNOPSIS 


#include <stdio.h> 
#include <math.h> 


DESCRIPTION 


This section describes functions found in various libraries, other 
than those functions that directly invoke UNIX system primitives, 
which are described in Section 2 of this volume. Certain major col- 
lections are identified by a letter after the section number: 


(3C) These functions, together with those of Section 2 and those 
marked (3S), constitute the Standard C Library /ibc , which is 
automatically loaded by the C compiler, cc (7). The link editor 
ld (1) searches this library under the —Ic option. Declarations 
for some of these functions may be obtained from #include 
files indicated on the appropriate pages. 

(3S) These functions constitute the “standard I/O package’ (see 
Stdio (3S)). These functions are in the library libc , already 
mentioned. Declarations for these functions may be obtained 
from the #include file <stdio.h> . 

(3M) These functions constitute the Math Library, libm . They are 
automatically loaded as needed by the FORTRAN compiler 
{77 (1). They are not automatically loaded by the C compiler, 
cc (1); however, the link editor searches this library under the 
-—Im option. Declarations for these functions may be obtained 
from the #include file <math.h> . Several generally useful 
mathematical constants are also defined there (see math 
(5)). 

(3X) Various specialized libraries. The files in which these 
libraries are found are given on the appropriate pages. 

(3F) These functions constitute the FORTRAN intrinsic function 
library, ibF77 . These functions are automatically available to 
the FORTRAN programmer and require no special invocation 
of the compiler. 


DEFINITIONS 
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A character is any bit pattern able to fit into a byte on the machine. 
The null character is a character with value 0, represented in the C 
language as \0’. A character array is a sequence of characters. A 
null-terminated character array is a sequence of characters, the last 
of which is the null character . A string is a designation for a null- 
terminated character array . The null string is a character array 
containing only the null character. A NULL pointer is the value that 
is obtained by casting 0 into a pointer. The C language guarantees 
that this value will not match that of any legitimate pointer, so many 
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functions that return pointers return it to indicate an error. NULL is 
defined as 0 in <stdio.h> ; the user can include an appropriate fe | 
definition if not using <stdio.h> . ae 


Many groups of FORTRAN intrinsic functions have generic function 
names that do not require explicit or implicit type declaration. The 
type of the function will be determined by the type of its 
argument(s). For example, the generic function max will return an 
integer value if given integer arguments (max0O), a real value if given 
real arguments (amax?), or a double-precision value if given 
double-precision arguments (dmax7). 


FILES 
/lib/libc.a 
Nib/liom.a 
/usr/lib/libF77.a 


SEE ALSO 
intro(2), stdio(3S), math(5). 
ar(1), cc(1), f77(1), Id(1), lint(1), nm(1) in the Sys5 UNIX User Refer- 
ence Manual. 


DIAGNOSTICS 
Functions in the C and Math Libraries (83C and 3M) may return the | 
conventional values 0 or +HUGE (the largest-magnitude single- = 
precision floating-point numbers; HUGE is defined in the <math.h> “\ 
header file) when the function is undefined for the given arguments 
or when the value is not representable. In these cases, the external 
variable errno (see intro (2)) is set to the value EDOM or ERANGE. 
As many of the FORTRAN intrinsic functions use the routines found 
in the Math Library, the same conventions apply. 


WARNING 

Many of the functions in the libraries call and/or refer to other func- 
tions and external variables described in this section and in section 
2 (System Calls). \f a program inadvertantly defines a function or 
external variable with the same name, the presumed library version 
of the function or external variable may not be loaded. The /int(1) 
program checker reports name conflicts of this kind as “multiple 
declarations” of the names in question. Definitions for sections 2, 
3C, and 3S are checked automatically. Other definitions can be 
included by using the —I option (for example, —Im includes definitions 
for the Math Library, section 3M). Use of /int is highly recom- 
mended. 


— 
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NAME 

a64l, |64a — convert between long integer and base-64 ASCII string 
SYNOPSIS 

long a64l (s) 

char +s; 

char +164a (I) 

long |; 


DESCRIPTION 


BUGS 
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These functions are used to maintain numbers stored in base-64 
ASCil characters. This is a notation by which long integers can be 
represented by up to six characters; each character represents a 
“digit” in a radix-64 notation. 


The characters used to represent “digits” are . for 0, / for 1, 0 
through 9 for 2—11, A through Z for 12-37, and a through z for 
38-63. 


A64/ takes a pointer to a null-terminated base-64 representation and 
returns a corresponding long value. If the string pointed to by s 
contains more than six characters, a64/ will use the first six. 


L64a takes a long argument and returns a pointer to the 
corresponding base-64 representation. If the argument is 0, /64a 
returns a pointer to a null string. 


The value returned by /64a is a pointer into a static buffer, the con- 
tents of which are overwritten by each call. 
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NAME 
abort — generate an IOT fault - | yrs 


SYNOPSIS aa, 
int abort ( ) 


DESCRIPTION 
Abort first closes all open files if possible, then causes an IOT signal 


to be sent to the process. This usually results in termination with a 
core dump. 


_ It is possible for abort to return control if SIGIOT is caught or ignored, 
in which case the value returned is that of the kill (2) system call. 


SEE ALSO 
exit(2), kill(2), signal(2). 
adb(1), in the Sys5 UNIX User Reference Manual. 
DIAGNOSTICS 
lf SIGIOT is neither caught nor ignored, and the current directory is 


writable, a core dump is produced and the message “abort — core 
dumped” is written by the shell. 


oO™ 
i , 


Ne 
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NAME 
| abs — return integer absolute value 

SYNOPSIS 
int abs (i) 
int {; 

DESCRIPTION 
Abs returns the absolute value of its integer operand. 

BUGS 
In two's-compiement representation, the absolute value of the nega- 
tive integer with largest magnitude is undefined. Some implementa- 
tions trap this error, but others simply ignore it. 

SEE ALSO 


floor(3M). 
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NAME 
bsearch — binary search a sorted table ~ 


SYNOPSIS a Me 
#include <search.h> 


char +bsearch ((char +) key, (char *) base, nel, sizeof (+key), 
compar) 

unsigned nel; 

int (*compar)( ); 


DESCRIPTION 

Bsearch is a binary search routine generalized from Knuth (6.2.1) 
Algorithm B. It returns a pointer into a table indicating where a 
datum may be found. The table must be previously sorted in 
increasing order according to a provided comparison function. Key 
points to a datum instance to be sought in the table. Base points to 
the element at the base of the table. Ne/ is the number of elements 
in the table. Compar is the name of the comparison function, which 
is called with two arguments that point to the elements being com- 
pared. The function must return an integer less than, equal to, or 
greater than zero as accordinly the first argument is to be con- 
sidered less than, equal to, or greater than the second. 


EXAMPLE |  ™ 
The example below searches a table containing pointers to nodes . / 
consisting of a string and its length. The table is ordered alphabeti- 

cally on the string in the node pointed to by each entry. 


This code fragment reads in strings and either finds the correspond- 
ing node and prints >5ut the string and its length, or prints an error 
message. 


#include <stdio.h> 
#include <search.h> 


#define TABSIZE 1000 


struct node { /* these are stored in the table */ 
char «string; 
int length; 

ie 

struct node table[TABSIZE]; /* table to be searched */ 


struct node «node_ptr, node; eee 
int node_compare( ); /* routine to compare 2 nodes */ 
char str_space[20]; /* space to read string into */ 
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node.string = str_space; 
while (scanf("%s", node.string) != EOF) { 
node_ptr = (struct node «)bsearch((char «)(&node 
(char «)table, TABSIZE, 
sizeof(struct node), node_compare); 
if (Node_ptr !'= NULL) { 
(void)printf("string = %20s, length = %d\i 
node_pir—>string, node_ptr—>len 
' else { 
(void)printf(“not found: %s\n", node.string): 


1 
{ 


This routine compares two nodes based on an 
alphabetical ordering of the string field. 


int 
node_compare(node1, node2) 
struct node «node1, *node2; 


return strcmp(node1—>string, node2—>string); 
i 
NOTES 

The pointers to the key and the element at the base of the table 
should be of type pointer-to-element, and cast to type pointer-to- 
character. 
The comparison function need not compare every byte, so arbitrary 
data may be contained in the elements in addition to the values 
being compared. 
Although declared as type pointer-to-character, the value returned 
should be cast into type pointer-to-element. 


SEE ALSO 
hsearch(3C), lsearch(3C), qsort(3C), tsearch(3C). 


DIAGNOSTICS 
A NULL pointer is returned if the key cannot be found in the table. 
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NAME ; 
clock — report CPU time used a e 

SYNOPSIS ew 
long clock ( ) 

DESCRIPTION 


Clock returns the amount of CPU time (in microseconds) used since 
the first call to clock . The time reported is the sum of the user and 
system times of the calling process and its terminated child 
processes for which it has executed wait (2) or system (3S). 


The resolution of the clock is 15.625 milliseconds. 


SEE ALSO 
times(2), wait(2), system(3S). 


BUGS 
The value returned by c/ock is defined in microseconds for compati- 
bility with systems that have CPU clocks with much higher resolu- 
tion. Because of this, the value returned will wrap around after 
accumulating only 2147 seconds of CPU time (about 36 minutes). 


fo™N 


1 : 
Ra, A 
Me ue 
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NAME 


toupper, tolower, _toupper, _tolower, toascii — translate characters 


SYNOPSIS 


#include <ctype.h> 


int toupper (c) 
int c; 


int tolower (c) 
int c; 

int _toupper (c) 
int c; 

int _tolower (c) 
int c; 

int toascii (c) 
int c; 


DESCRIPTION 


Toupper and tolower have as domain the range of getc (3S): the 
integers from -—1 through 255. If the argument of ftoupper 
represents a lower-case letter, the result is the corresponding 
upper-case letter. If the argument of tolower represents an upper- 


case letter, the result is the corresponding lower-case letter. All 


other arguments in the domain are returned unchanged. 


The macros _toupper and _tolower , are macros that accomplish 
the same thing as foupper and tolower but have restricted domains 
and are faster. _toupper requires a lower-case letter as its argu- 
ment; its result is the corresponding upper-case letter. The macro 
_tolower requires an upper-case letter as its argument; its result is 
the corresponding lower-case letter. Arguments outside the domain 
Cause undefined results. 


Toascii yields its argument with all bits turned off that are not part of 
a standard ASCII character; it is intended for compatibility with other 
systems. 


SEE ALSO 
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ctype(3C), getc(3S). 
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NAME oN 
crypt, setkey, encrypt — generate DES encryption a, 


SYNOPSIS 
char «crypt (key, salt) 
char +key, «Salt; 


void setkey (key) 
char +key; 


void encrypt (block, edflag) 
char +block; 
int edflag; 


DESCRIPTION 
Crypt is the password encryption function. It is based on the NBS 
Data Encryption Standard (DES), with variations intended (among 
other things) to frustrate use of hardware implementations of the 
DES for key search. 


Key is a user's typed password. Sa/t is a two-character string 
chosen from the set [a-zA-Z0-9./]; this string is used to perturb the 
DES algorithm in one of 4096 different ways, after which the pass- 
word is used as the key to encrypt repeatedly a constant string. 
The returned value points to the encrypted password. The first two ~ 
characters are the salt itself. | Re iil 


The setkey and encrypt entries provide (rather primitive) access to 
the actual DES algorithm. The argument of setkey is a character 
array of length 64 containing only the characters with numerical 
value 0 and 1. If this string is divided into groups of 8, the low-order 
bit in each group is ignored; this gives a 56-bit key which is set into 
the machine. This is the key that will be used with the above men- 
tioned algorithm to encrypt or decrypt the string block with the func- 
tion encrypt . 


The argument to the encrypt entry is a character array of length 64 
containing only the characters with numerical value 0 and 1. The 
argument array is modified in place to a similar array representing 
the bits of the argument after having been subjected to the DES 
algorithm using the key set by setkey . If edflag is zero, the argu- 
ment is encrypted; if non-zero, it is decrypted. 


SEE ALSO 
getpass(3C), passwd(4). 
login(1), passwd(1) in the Sys5 UNIX User Reference Manual. 

BUGS o™ 
The return value points to static data that are overwritten by each ~ / 
call. 


Page 1 May 21, 1985 


CTERMID(3S) UNIX Sys5 CTERMID(3S) 


NAME 


ctermid — generate file name for terminal 


SYNOPSIS 


#include <stdio.h> 
char +*ctermid (s) 
char <s; 


DESCRIPTION 


NOTES 


Ctermid generates the path name of the controlling terminal for the 
current process, and stores it in a string. 


If s is a NULL pointer, the string is stored in an internal static area, 
the contents of which are overwritten at the next call to cfermid , 
and the address of which is returned. Otherwise, s is assumed to 
point to a character array of at least L_ctermid elements; the path 
name is placed in this array and the value of s is returned. The 
constant L_ctermid is defined in the <stdio.h> header file. 


The difference between ctermid and ttyname (3C) is that ttyname 
must be handed a file descriptor and returns the actual name of the 
terminal associated with that file descriptor, while cfermid returns a 
string (/dev/tty) that will refer to the terminal if used as a file name. 
Thus ftyname is useful only if the process already has at least one 
file open to a terminal. 


SEE ALSO 
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ttyname(3C). 
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NAME : 
ctime, localtime, gmtime, asctime, tzset — convert date and time to’ > 
string eal) 

SYNOPSIS 


#include <time.h> 


char *ctime (clock) 
long «clock; 


struct tm +*localtime (clock) 
long «clock; 


struct tm *gmtime (clock) 
long *clock; 


char *asctime (tm) 
struct tm «tm; 


extern long timezone; 
extern int daylight; 
extern char *«tzname[2]; 
void tzset ( ) 


DESCRIPTION 
| Ctime converts a long integer, pointed to by clock , representing the © 
time in seconds since 00:00:00 GMT, January 1, 1970, and returns ~ 
a pointer to a 26-character string in the following form. All the fields 
have constant width. 


Sun Sep 16 01:03:52 1973\n\0 


Localtime and gmtime return pointers to “tm” structures, described 
below. Localtime corrects for the time zone and possible Daylight 
Savings Time; gmtime converts directly to Greenwich Mean Time 
(GMT), which is the time the UNIX system uses. 


Asctime converts a “tm” structure to a 26-character string, as 
shown in the above example, and returns a pointer to the string. 
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Declarations of all the functions and externals, and the ‘tm’ struc- 


( : ture, are in the <time.h> header file. The structure declaration is: 
= struct tm { 
int tm_sec; /* seconds (0 - 59) */ 
int tm_min; /* minutes (O - 59) */ 
int tm_hour; /* hours (0 - 23) */ 
int tm_mday; /* day of month (1 - 31) */ 
int tm_mon; /* month of year (O - 11) */ 
int tm_year; /* year — 1900 */ 
int tm_wday; /* day of week (Sunday = Q) */ 
int tm_yday; /*x day of year (0 - 365) */ 
int tm_isdst; 
if 


Tm_isdst is non-zero if Daylight Savings Time is in effect. 


The external long variable timezone contains the difference, in 

seconds, between GMT and local standard time (in EST, timezone is 

5*60*60); the external variable daylight is non-zero if and only if the 

standard U.SA. Daylight Savings Time conversion should be 

applied. The program knows about the peculiarities of this conver- 

sion in 1974 and 1975; if necessary, a table for these years can be 
( ‘ extended. 


If an environment variable named TZ is present, asctime uses the 
contents of the variable to override the default time zone. The value 
of TZ must be a three-letter time zone name, followed by a number 
representing the difference between local time and Greenwich Mean 
Time in hours, followed by an optional three-letter name for a day- 
light time zone. For example, the setting for New Jersey would be 
EST5EDT . The effects of setting TZ are thus to change the values of 
the external variables timezone and daylight ; in addition, the time 
zone names contained in the external variable 


char *tzname[2] = { "EST", "EDT" }; 


are set from the environment variable TZ . The function tzset sets 
these external variables from TZ ; tzset is called by asctime and 
may also be called explicitly by the user. 


Note that in most installations, TZ is set by default when the user 
logs on, to a value in the local /etc/profile file (see profile (4)). 


SEE ALSO 
time(2), getenv(3C), profile(4), environ(5). 


. BUGS 
( The return values point to static data whose content is overwritten 
by each call. 
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NAME 
isalpha, isupper, islower, isdigit, isxdigit, isalnum, isspace, ispunct,~ 
isprint, isgraph, iscntrl, isascii — classify characters es 
SYNOPSIS 
#include <ctype.h> 
int isalpha (c) 
int c; 
DESCRIPTION 
These macros classify character-coded integer values by table 
lookup. Each is a predicate returning nonzero for true, zero for 
false. /sascii is defined on all integer values; the rest are defined 
only where /sascii is true and on the single non-ASCll value EOF (—1 
— see stdio (3S)). 
isalpha c is a letter. 
isupper Cc is an upper-case letter. 
islower C is a lower-case letter. 
isdigit c is a digit [0-9]. 
isxdigit c is a hexadecimal digit [0-9], [A-F] or [a-f]. a 
isainum c is an alphanumeric (letter or digit). 4 
isspace Cc is a space, tab, carriage return, new-line, vertical 
tab, or form-feed. 
ispunct Cc is a punctuation character (neither control nor 
alphanumeric). 
isprint | c is a printing character, code 040 (space) through 
0176 (tilde). | 
isgraph ¢ is a printing character, like ‘sprint except false for 
space. 
iscntrl Cc is a delete character (0177) or an ordinary con- 
trol character (less than 040). 
isascit c is an ASCII character, code less than 0200. 
DIAGNOSTICS 
If the argument to any of these macros is not in the domain of the 
function, the result is undefined. 
SEE ALSO 7 
stdio(3S), ascii(5). a 
on y 


Page 1 May 7, 1986 


CUSERID(3S) UNIX Sys5 CUSERID(3S) 


_. NAME 
( ' cuserid — get character login name of the user 
| SYNOPSIS 
#include <stdio.h> 
char *cuserid (s) 
char +S; 
DESCRIPTION 


Cuserid generates a character-string representation of the login 
name that the owner of the current process is logged in under. If s 
is a NULL pointer, this representation is generated in an internal 
static area, the address of which is returned. Otherwise, s_ is 
assumed to point to an array of at least L_cuserid characters; the 
representation is left in this array. The constant L_cuserid is 
defined in the <stdio.h> header file. 


DIAGNOSTICS 
If the login name cannot be found, cuserid returns a NULL pointer; if 
S is not a NULL pointer, a null character (\0) will be placed at s/O] . 


SEE ALSO 
getlogin(3C), getpwent(3C). 


te 
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NAME - 
dial — establish an out-going terminal line connection ( ‘ 
SYNOPSIS et 
#include <dial.h> 
int dial (call) 
CALL call; 
void undial (fd) 
int fd; 
DESCRIPTION 
Dial returns a file-descriptor for a terminal line open for read/write. 
The argument to o/a/ is a CALL structure (defined in the <dial.h> 
header file). 
When finished with the terminal line, the calling program must 
invoke undial to release the semaphore that has been set during the 
allocation of the terminal device. 
The definition of CALL in the <dial.h> header file is: 
typedef struct { 
struct termio «attr; /* pointer to termio attribute struct «/ 
int baud; /* transmission data rate */ oo 
int speed;  /* 212A modem: low=300, high=120° 
char «line: /*« device name for out-going line */  <..” 
char *telno; /* pointer to tel-no digits string */ 
int modem; /* specify modem control for direct lines */ 
char | “device; /*Will hald the name of the device used 
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to make a connection */ 
int dev_len; /* The length of the device used to 
| make connection */ 
} CALL; 


The CALL element speed is intended only for use with an outgoing 
dialed call, in which case its value should be either 300 or 1200 to 
identify the 113A modem, or the high- or low-speed setting on the 
212A modem. Note that the 113A modem or the low-speed setting 
of the 212A modem will transmit at any rate between 0 and. 300 bits 
per second. However, the high-speed setting of the 212A modem 
transmits and receivers at 1200 bits per secound only. The CALL 
element baud is for the desired transmission baud rate. For exam- 
ple, one might set baud to 110 and speed to 300 (or 1200). How- 
ever, if speed set to 1200 baud must be set to high (1200). 


If the desired terminal line is a direct line, a string pointer to its 
device-name should be placed in the /ine element in the CALL struc- 
ture. Legal values for such terminal device names are kept in the 
L-devices file. In this case, the value of the baud element need not 
be specified as it will be determined from the L-devices file. 


October 7, 1986 


DIAL(3C) UNIX Sys5 DIAL(3C) 


The te/no element is for a pointer to a character string representing 
( - the telephone number to be dialed. Such numbers may consist only 
| of symbols described on the acu (7). The termination symbol will be 
supplied by the dia/ function, and should not be included in the te/no 

string passed to o/a/ in the CALL structure. 


The CALL element modem is used to specify modem control for 
direct lines. This element should be non-zero if modem control is 
required. The CALL element attr is a pointer to a termio structure, 
as defined in the termio.h header file. A NULL value for this pointer 
element may be passed to the d/a/ function, but if such a structure 
is included, the elements specified in it will be set for the outgoing 
terminal line before the connection is established. This is often 
important for certain attributes such as parity and baud-rate. 


The CALL element device is used to hold the device name (cul..) 
that establishes the connection. 


The CALL element dev_/en is the length of the device name that is 
copied into the array device. 


FILES 
/usr/lib/uucp/L-devices 
/usr/spool/uucp/LCK..fty-device 


( SEE ALSO 
uucp(1C) in the Sys5 UNIX User Reference Manual. 
alarm(2), read(2), write(2). 
tty(7) in the "Sys5 UNIX Administrator Reference Manual" . 


DIAGNOSTICS 
On failure, a negative value indicating the reason for the failure will 
be returned. Mnemonics for these negative indices as listed here 
are defined in the <dial.h> header file. 


INTRPT —1 /* interrupt occurred */ 

D_HUNG —2 /* dialer hung (no return from write) +/ 
NO_ANS —3 /* no answer within 10 seconds */ 
ILL_BD —4 /* illegal baud-rate */ 

A_PROB —5 /* acu problem (open() failure) */ 

| PROB —H /* line problem (open() failure) */ 
NO_Ldv —7 /* can't open LDEVS file */ 

DV_NTA -8 /* requested device not available «/ 
DV.NTK -9 /* requested device not known */ 

NO BDA -—10 /* no device available at rqst'd baud */ 
NO_BD_K —11 /* no device Known at requested baud */ 


WARNINGS 
| Including the <dial.h> header file automatically includes the 
<termio.h> header file. 
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The above routine uses <stdio.h>, which causes it to increase oe 
size of programs, not otherwise using standard |/O. 


BUGS war 
An alarm (2) system call for 3600 seconds is made (and caught) 
within the dial module for the purpose of “touching” the LCK.. file 
and constitutes the device allocation semaphore for the terminal 
device. Otherwise, uucp (1C) may simply delete the LCK.. entry on 
its 90-minute clean-up rounds. The alarm may go off while the user 
program is in a read (2) or write (2) system call, causing an 
apparent error return. If the user program expects to be around for 
an hour or more, error returns from read s should be checked for 
(errno= =EINTR), and the read possibly reissued. 


Sy 
i : 
f. 
X f 
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NAME 


drand48, erand48, lrand48, nrand48, mrand48, jrand48, srand48, 
seed48, Icong48 — generate uniformly distributed pseudo-random 
numbers 


SYNOPSIS 


double drand48 ( ) 


double erand48 (xsubi) 
unsigned short xsubi[3]; 


long lIrand48 ( ) 


long nrand48 (xsubi) 
unsigned short xsubi[3]; 


long mrand48 ( ) 


long jrand48 (xsubi) 
unsigned short xsubi[3]; 


void srand48 (seedval) 
long seedval; 


unsigned short *seed48 (seed16v) 
unsigned short seed16v{3]; 


void Icong48 (param) 
unsigned short param[7]; 


DESCRIPTION 
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This family of functions generates pseudo-random numbers using 
the well-known linear congruential algorithm and 48-bit integer arith- 
metic. 


Functions drand48 and erand48 return non-negative double- 
precision floating-point values uniformly distributed over the interval 
[0.0, 1.0). 


Functions frand48 and nrand48 return non-negative long integers 
uniformly distributed over the interval [0, 2°’). 


Functions mrand48 and jrand48 return signed long integers uni- 
formly distributed over the interval [-2”, 2°"). 


Functions srand48, seed48 and /cong48 are initialization entry 
points, one of which should be invoked before either drand48, 
lrand48 or mrand48 is called. (Although it is not recommended 
practice, constant default initializer values will be supplied automati- 
cally if drand48, lrand48 or mrand48 is called without a prior call to 
an initialization entry point.) Functions erand48, nrand48 and 
jrand48 do not require an initialization entry point to be called first. 


All the routines work by generating a sequence of 48-bit integer 
values, X;, according to the linear congruential formula 
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Xn ia = (8X, + © )mog m n=0. 


formed. Unless /cong48 has been invoked, the multiplier value a 
and the addend value c are given by 


a = 5DEECEGE6D ,, = 273673163155, 


The value returned by any of the functions drand48, erand48, 
lrand48, nrand48, mrand48 or jrand48 is computed by first generat- 
ing the next 48-bit X, in the sequence. Then the appropriate 
number of bits, according to the type of data item to be returned, 
are copied from the high-order (leftmost) bits of X,; and transformed 
into the returned value. 


The functions drand48, lrand48 and mrand48 store the last 48-bit 
X, generated in an internal buffer; that is why they must be initialized 
prior to being invoked. The functions erand48, nrand48 and 
jrand48 require the calling program to provide storage for the suc- 
cessive X, values in the array specified as an argument when the 
functions are invoked. That is why these routines do not have to be 
initialized; the calling program merely has to place the desired initial 
value of X, into the array and pass it as an argument. By using dif- 


The parameter m = 2°: hence 48-bit integer arithmetic is per- ‘ 7 


ferent arguments, functions erand48, nrand48 and jrand48 allow ~— 
separate modules of a large program to generate several indepen- . 


dent streams of pseudo-random numbers, i.e., the sequence of 
numbers in each stream will not depend upon how many times the 
routines have been called to generate numbers for the other 
streams. 


The initializer function srand48 sets the high-order 32 bits of X, to 
the 32 bits contained in its argument. The low-order 16 bits of X, 
are set to the arbitrary value 330E,.. 


The initializer function seed48 sets the value of X; to the 48-bit 
value specified in the argument array. In addition, the previous 
value of X, is copied into a 48-bit internal buffer, used only by 
seed48, and a pointer to this buffer is the value returned by seed48. 
This returned pointer, which can just be ignored if not needed, is 
useful if a program is to be restarted from a given point at some 
future time — use the pointer to get at and store the last X, value, 
and then use this value to reinitialize via seed48 when the program 
is restarted. 


The initialization function /cong48 allows the user to specify the ini- 
tial X;, the multiplier value a, and the addend value c. Argument 


array elements param/[0-2] specify X,, param[3-5] specify the multi- , ) 


plier a, and param/[6] specifies the 16-bit addend c. After icong48 
has been called, a subsequent call to either srand48 or seed4é will 
restore the “standard” multiplier and addend values, a and c, 
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( ~ NOTES 


specified on the previous page. 


The routines are coded in portable C. The source code for the port- 
able version can even be used on computers which do not have 
floating-point arithmetic. In such a situation, functions drand48 and 
erand48 do not exist; instead, they are replaced by the two new 
functions below. 


long irand48 (m) 
unsigned short m; 


long krand48 (xsubi, m) 
unsigned short xsubi[3], m; 


Functions irand48 and krand48.'\f return non-negative long integers 
uniformly distributed over the interval [0, m — 1]. 


SEE ALSO 
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rand(3C). 
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NAME 


ecvt, fevt, gcvt — convert floating-point number to string 


SYNOPSIS 


char *ecvt (value, ndigit, decpt, sign) 
double value; 
int ndigit, «decpt, *sign; 


char +*fcvt (value, ndigit, decpt, sign) 
double value; 
int ndigit, *«decpt, sign; 


char +gcvt (value, ndigit, buf) 
double value; 

int ndigit; 

char «buf; 


DESCRIPTION 


Ecvt converts value to a null-terminated string of ndigit digits and 
returns a pointer thereto. The high-order digit is non-zero, unless 
the value is zero. The low-order digit is rounded. The position of 
the decimal point relative to the beginning of the string is stored 
indirectly through decpt (negative means to the left of the returned 
digits). The decimal point is not included in the returned string. If 


the sign of the result is negative, the word pointed to by sign is / sid 


non-zero, otherwise it is zero. 


Fevt is identical to ecvt, except that the correct digit has been 
rounded for printf “%f"” (FORTRAN F-format) output of the number of 
digits specified by ndigit . 


Gevt converts the va/ue to a null-terminated string in the array 
pointed to by buf and returns buf. It attempts to produce ndigit sig- 
nificant digits in FORTRAN F-format if possible, otherwise E-format, 
ready for printing. A minus sign, if there is one, or a decimal point 
will be included as part of the returned string. Trailing zeros are 
suppressed. 


SEE ALSO 


BUGS 
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printf(3S). 


The values returned by ecvt and fcvt point to a single static data 
array whose content is overwritten by each call. 
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NAME 


end, etext, edata — last locations in program 


SYNOPSIS 


extern end; 
extern etext; 
extern edata; 


DESCRIPTION 


These names refer neither to routines nor to locations with interest- 
ing contents. The address of etext is the first address above the 
program text, edafa above the initialized data region, and end 
above the uninitialized data region. 


When execution begins, the program break (the first location beyond 
the data) coincides with end , but the program break may be reset 
by the routines of brk (2), malloc (3C), standard input/output 
(stdio(3S)), the profile (-p) option of cc (7), and so on. Thus, the 
Current value of the program break should be determined by sbrk(0) 
(see Ork (2)). 


SEE ALSO 


Page 1 


brk(2), malloc(3C), stdio(3S). 
cc(1) in the Sys5 UNIX User Reference Manual. 
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NAME | jx 
-_fclose, fflush — close or flush a stream ' J 
SYNOPSIS ~ 
#include <stdio.h> 
int fclose (stream) 
FILE «stream; 
int fflush (stream) 
FILE +stream; 
DESCRIPTION 
Fclose causes any buffered data for the named stream to be written 
out, and the stream to be closed. 
Fclose is performed automatically for all open files upon calling exit 
(2). 
Fflush causes any buffered data for the named stream to be written 
to that file. The stream remains open. 
DIAGNOSTICS | : 
These functions return 0 for success, and EOF if any error (such as 
trying to write to a file that has not been opened for writing) was 
detected. a 
SEE ALSO et 
close(2), exit(2), fopen(3S), setbuf(3S). 
eo 
Sw 
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~~ NAME 
| ferror, feof, clearerr, fileno — stream status inquiries 


~ SYNOPSIS 
#include <stdio.h> 


int ferror (stream) 
FILE *stream; 


int feof (stream) 
FILE *stream; 


void clearerr (stream) 
FILE «stream; 


int fileno (stream) 
FILE «stream; 


DESCRIPTION 
Ferror returns non-zero when an |/O error has previously occurred 
reading from or writing to the named stream , otherwise zero. 


Feof returns non-zero when EOF has previously been detected 
reading the named input stream , otherwise zero. 


| Clearerr resets the error indicator and EOF indicator to zero on the 
( named stream . 


Fileno returns the integer file descriptor associated with the named 
stream ; see open (2). 


NOTE 
All these functions are implemented as macros; they cannot be 
declared or redeclared. 


SEE ALSO 
open(2), fopen(3S). 
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NAME t 
fopen, freopen, fdopen — open a stream re, 


SYNOPSIS 
#include <stdio.h> 


FILE *fopen (file-name, type) 
char *file-name, «type; 


FILE +freopen (file-name, type, stream) 
char +*file-name, «type; 
FILE *stream; 


FILE *fdopen (fildes, type) 
int fildes; 
char «type; 


DESCRIPTION 
Fopen opens the file named by file-name and associates a stream 
with it. Fopen returns a pointer to the FILE structure associated with 
the stream . 


File-name points to a character string that contains the name of the 
file to be opened. 


Type is a character string having one of the following values: -—- 
ake open for reading i 
"Ww" truncate or create for writing 
"a" append; open for writing at end of file, or create 
for writing 
eo open for update (reading and writing) 
WH" truncate or create for update 
"at" append; open or create for update at end-of-file 


Freopen substitutes the named file in place of the open stream . 
The original stream is closed, regardless of whether the open ulti- 
mately succeeds. Freopen returns a pointer to the FILE structure 
associated with stream . 


Freopen is typically used to attach the preopened streams associ- 
ated with stdin , stdout and stderr to other files. 


Fdopen associates a stream with a file descriptor. File descriptors 
are obtained from open , dup , creat , or pipe (2), which open files 
but do not return pointers to a FILE structure stream. Streams are 
necessary input for many of the Section 35 library routines. The f a 
type of stream must agree with the mode of the open file. on J 


When a file is opened for update, both input and output may be 
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done on the resulting stream . However, output may not be directly 
followed by input without an intervening fseek or rewind , and input 
may not be directly followed by output without an intervening fseek , 
rewind , or an input operation which encounters end-of-file. 


When a file is opened for append (i.e., when type is "a" or "a+"), it 
is impossible to overwrite information already in the file. Fseek may 
be used to reposition the file pointer to any position in the file, but 
when output is written to the file, the current file pointer is disre- 
garded. All output is written at the end of the file and causes the file 
pointer to be repositioned at the end of the output. If two separate 
processes open the same file for append, each process may write 
freely to the file without fear of destroying output being written by 
the other. The output from the two processes will be intermixed in 
the file in the order in which it is written. 


SEE ALSO 


creat(2), dup(2), open(2), pipe(2), fclose(3S), fseek(3S). 


DIAGNOSTICS 


Fopen and freopen return a NULL pointer on failure. 
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NAME 


fread, fwrite — binary input/output 


SYNOPSIS 


#include <stdio.h> 


int fread (ptr, size, nitems, stream) 
char «ptr; 

int size, nitems; 

FILE «stream; 


int fwrite (ptr, size, nitems, stream) 
char «ptr; 

int size, nitems; 

FILE *stream; 


DESCRIPTION 


Fread copies, into an array pointed to by ptr, nitems items of data 
from the named input stream , where an item of data is a sequence 
of bytes (not necessarily terminated by a null byte) of length size . 
Fread stops appending bytes if an end-of-file or error condition is 
encountered while reading stream, or if nitems items have been 
read. Fread leaves the file pointer in stream , if defined, pointing to 
the byte following the last byte read if there is one. Fread does not 
change the contents of stream . 


Fwrite appends at most nitems items of data from the array pointed _ 


to by ptr to the named output stream . Fwrite stops appending 
when it has appended nitems items of data or if an error condition is 
encountered on stream . Fwrite does not change the contents of the 
array pointed to by pir. 


The argument size is typically sizeof(*ptr) where the pseudo- 
function sizeof specifies the length of an item pointed to by pfr . If 
ptr points to a data type other than char it should be cast into a 
pointer to char. 


SEE ALSO 


read(2), write(2), fopen(3S), getc(3S), gets(3S), printf(3S), putc(3S), 
puts(3S), scanf(3S). 


DIAGNOSTICS 
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Fread and fwrite return the number of items read or written. If size 
or nitems is non-positive, no characters are read or written and 0 is 
returned by both fread and fwrite . 
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NAME 


} 


frexp, Idexp, modf — manipulate parts of floating-point numbers 


SYNOPSIS 


double frexp (value, eptr) 
double value; 
int *eptr; 


double Idexp (value, exp) 
double value; 
int exp; 


double modf (value, iptr) 
double value, <iptr; 


DESCRIPTION 


Every non-zero number can be written uniquely as x * 2” , where 
the “mantissa” (fraction) x is in the range 0.5 =< |x| < 1.0, and the 
“exponent” rn is an integer. Frexp returns the mantissa of a double 
value , and stores the exponent indirectly in the location pointed to 
by eptr . If value is zero, both results returned by frexp are zero. 
Ldexp returns the quantity value *« 2 °*? | 

Moodf returns the signed fractional part of value and stores the 
integral part indirectly in the location pointed to by /ptr . 


~~ DIAGNOSTICS 
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If Idexp would cause overflow, + HUGE is returned (according to the 
sign of value ), and errno is set to ERANGE . 

lf (dexp would cause underflow, zero is returned and errno is set to 
ERANGE . 
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NAME : oN 
fseek, rewind, ftell — reposition a file pointer in a stream { 


SYNOPSIS 
#include <stdio.h> 


int fseek (stream, offset, ptrname) 
FILE «stream; 

long offset; 

int ptrname; 


void rewind (stream) 
FILE *stream; 


long ftell (stream) 
FILE «stream; 


DESCRIPTION 
Fseek sets the position of the next input or output operation on the 
stream . The new position is at the signed distance offset bytes 
from the beginning, from the current position, or from the end of the 
file, according as ptrname has the value 0, 1, or 2. 


Rewind ( stream ) is equivalent to fseek ( stream , OL, 0), except 
that no value is returned. 


Fseek and rewind undo any effects of ungetc (3S). KS owt 
After fseek or rewind , the next operation on a file opened for 
update may be either input or output. 
Ftell returns the offset of the current byte relative to the beginning of 
the file associated with the named stream . 
SEE ALSO , 
lseek(2), fopen(3S), popen(3S), ungetc(3$S). 
DIAGNOSTICS 
Fseek returns non-zero for improper seeks, otherwise zero. An 
improper seek can be, for example, an fseek done on a file that has 
not been opened via fopen ; in particular, fseek may not be used on 
a terminal, or on a file opened via popen (3S). 
WARNING 
Although on the UNIX system an offset returned by fte// is meas- 
ured in bytes, and it is permissible to seek to positions relative to 
that offset, portability to non-UNIX systems requires that an offset 
be used by fseek directly. Arithmetic may not meaningfully be per- 
formed on such an offset, which is not necessarily measured in _ 
aS 
bytes. { 
NY 
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NAME 


ftw — walk a file tree 


SYNOPSIS 


#include <ftw.h> 


int ftw (path, fn, depth) 
char *path; 

int (*fn) (); 

int depth; 


DESCRIPTION 
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Ftw recursively descends the directory hierarchy rooted in path . 
For each object in the hierarchy, ftw calls fn , passing it a pointer to 
a null-terminated character string containing the name of the object, 
a pointer to a stat structure (see stat (2)) containing information 
about the object, and an integer. Possible values of the integer, 
defined in the <ftw.h>> header file, are FTW_F for a file, FTW_D for a 
directory, FTW_DNR for a directory that cannot be read, and FTW_NS 
for an object for which stat could not successfully be executed. If 
the integer is FTW_DNR, descendants of that directory will not be 
processed. If the integer is FTW_NS, the stat structure will contain 
garbage. An example of an object that would cause FTW_NS to be 
passed to fn would be a file in a directory with read but without exe- 
cute (search) permission. 


Ftw visits a directory before visiting any of its descendants. 


The tree traversal continues until the tree is exhausted, an invoca- 
tion of fn returns a nonzero value, or some error is detected within 
ftw (such as an |/O error). If the tree is exhausted, ftw returns zero. 
If fn returns a nonzero value, ftw stops its tree traversal and returns 
whatever value was returned by fn. If ffw detects an error, it returns 
—1, and sets the error type in errno . 


Ftw uses one file descriptor for each level in the tree. The depth 
argument limits the number of file descriptors so used. If depth is 
zero or negative, the effect is the same as if it were 1. Depth must 
not be greater than the number of file descriptors currently available 
for use. Ftw will run more quickly if depth is at least as large as the 
number of levels in the tree. 
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SEE ALSO 
stat(2), malloc(3C). 


BUGS 
Because ftw is recursive, it is possible for it to terminate with a 
memory fault when applied to very deep file structures. 
It could be made to run faster and use less storage on deep struc- 
tures at the cost of considerable complexity. 
Ftw uses malloc (3C) to allocate dynamic storage during its opera- 
tion. If ftw is forcibly terminated, such as by longjmp being exe- 
cuted by fn or an interrupt routine, ftw will not have a chance to free 
that storage, so it will remain permanently allocated. A safe way to 
handle interrupts is to store the fact that an interi.pt has occurred, 
and arrange to have fn return a nonzero value at its next invocation. 
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NAME 
getc, getchar, fgetc, getw — get character or word from a stream 


‘SYNOPSIS 
#include <stdio.h> 


int getc (stream) 
FILE *stream; 


int getchar () 


int fgetc (stream) 
FILE *stream; 


int getw (stream) 
FILE *stream; 


DESCRIPTION 
Getc returns the next character (byte) from the named input stream, 
as an integer. It also moves the file pointer, if defined, ahead one 
character in stream. Getchar is defined as getc(stdin). Getc and 
getchar are macros. 


Fgetc behaves like getc, but is a function rather than a macro. 
Fgetc runs more slowly than getc, but it takes less space per invo- 
cation and its name can be passed as an argument to a function. 


Getw returns the next word (integer) from the named input stream. 
Getw increments the associated file pointer, if defined, to point to 
the next word. The size of a word is the size of an integer and 
varies between machines. Getw has no special file. 


SEE ALSO 
fclose(3S), ferror(3S), fopen(3S), fread(3S), gets(3S), putc(3S), 
scanf(3S). 


DIAGNOSTICS 
These functions return the constant EOF at end-of-file or upon an 
error. Because EOF is a valid integer, use ferror (3S) to detect 
getw errors. 


WARNING 
If the integer value returned by getc, gefchar, or fgetc is stored into 
a character variable and compared against the integer constant 
EOF, the comparison may never succeed, because sign-extension of 
a character on widening to integer is machine-dependent. 


BUGS 
Because it is implemented as a macro, getc treats incorrectly a 
stream argument with side effects. In particular, getc(+f+ +) does 
not work sensibly. Fgetc should be used instead. 
Because of possible differences in word length and byte ordering, 
files written using putw are machine-dependent, and may not be 
read using getw on a different processor. 
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~- NAME 


getcwd — get path-name of current working directory 


SYNOPSIS 
char *getcwd (buf, size) 
char *buf; 
int size; 

DESCRIPTION 
Getcwd returns a pointer to the current directory path-name. The 
value of size must be at least two greater than the length of the 
path-name to be returned. 


If buf is a NULL pointer, getcwd will obtain size bytes of space using 
malloc (3C). In this case, the pointer returned by getcwd may be 
used as the argument in a subsequent call to free. 


The function is implemented by using popen (3S) to pipe the output 
of the pwd (7) command into the specified string space. 


EXAMPLE 
char «cwd, *getcwd(); 


if ((cwd = getcwd((char *)NULL, 64)) == NULL) { 
perror(“‘pwd’’); 
exit(1); 


1 
f 


printf(“%s\n", cwd); 
SEE ALSO 
malloc(3C), popen(3S). 
pwd(1) in the Sys5 UNIX User Reference Manual. 


DIAGNOSTICS 
Returns NULL with errno set if size is not large enough, or if an error 
ocurrs in a lower-level function. 
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NAME Fe 7S 
getenv — return value for environment name Meath 
SYNOPSIS | 
char *getenv (name) 
char *name; 
DESCRIPTION 


Getenv searches the environment list (see environ (5)) for a string 
of the form name = value, and returns a pointer to the va/ue in the 
current environment if such a string is present, otherwise a NULL 
pointer. 


SEE ALSO 
exec(2), putenv(3C), environ(5). 
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NAME 
( getgrent, getgrgid, getgrnam, setgrent, endgrent, fgetgrent — get 
; group file entry 


SYNOPSIS 
#include <grp.h> 


struct group *getgrent ( ) 
struct group *getgrgid (gid) 
int gid; 

struct group *getgrnam (name) 
char «name; 


void setgrent ( ) 
void endgrent { ) 


struct group «*fgetgrent (f) 
FILE +f; 


DESCRIPTION 
Getgrent , getgrgid and getgrnam each return pointers to an object 
with the following structure containing the broken-out fields of a line 
or in the /etc/group file. Each line contains a “group” structure, 
( defined in the <grp.h> header file. 


struct group { 
char *gr_name; /* the name of the group */ 
char  *gr_passwd; /* the encrypted group password */ 
int gr_gid; /* the numerical group ID */ 
char **gr_mem; /* vector of ptrs. to mem. names *; 
I 
Getgrent when first called returns a pointer to the first group struc- 
ture in the file; thereafter, it returns a pointer to the next group struc- 
ture in the file; so, successive calls may be used to search the 
entire file. Getgrgid searches from the beginning of the file until a 
numerical group id matching gid is found and returns a pointer to 
the particular structure in which it was found. Getgrnam searches 
from the beginning of the file until a group name matching name is 
found and returns a pointer to the particular structure in which it was 
found. If an end-of-file or an error is encountered on reading, these 
functions return a NULL pointer. 


A call to setgrent has the effect of rewinding the group file to allow 
; repeated searches. Endgrent may be called to close the group file 
( . when processing is complete. 


Fgetgrent returns a pointer to the next group structure in the stream 
f, which matches the format of /etc/group . 
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FILES 
/etc/group 

SEE ALSO 
getlogin(3C), getpwent(3C), group(4). 

DIAGNOSTICS 
A NULL pointer is returned on EOF or error. 

WARNING | | | 
The above routines use <stdio.h>, which causes them to increase 
the size of programs, not otherwise using standard |/O, more than 
might be expected. | 

BUGS 


All information is contained in a static area, so it must be copied if it 
is to be saved. 
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} 


NAME 
getlogin — get login name 

SYNOPSIS 
char +getlogin ( ); 

DESCRIPTION | 
Getlogin returns a pointer to the login name as found in /etc/utmp . 
It may be used in conjunction with getpwnam to locate the correct 
password file entry when the same user ID is shared by several 
login names. 
If getiogin is called within a process that is not attached to a termi- 
nal, it returns a NULL pointer. The correct procedure for determining 
the login name is to call cuserid , or to call getiogin and if it fails to 
Call getowuid . 

FILES 
/etc/utmp 

SEE ALSO 
cuserid(3S), getgrent(3C), getpwent(3C), utmp(4). 

DIAGNOSTICS | : 
Returns the NULL pointer if name is not found. 

BUGS 


The return values point to static data whose content is overwritten 
by each call. | 
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NAME 
getopt — get option letter from argument vector | | — 
\ ye 
SYNOPSIS a ee 
int getopt (argc, argv, optstring) 
int argc; 


char +*argv, *opstring; 


extern char +*optarg; 
extern int optind, opterr; 


DESCRIPTION 
Getopt returns the next option letter in argv that matches a letter in 
optstring . Optstring is a string of recognized option letters; if a 
letter is followed by a colon, the option is expected to have an argu- 
ment that may or may not be separated from it by white space. 
Optarg is set to point to the start of the option argument on return 
from getopt . 


Getopt places in optind the argv index of the next argument to be 
processed. Because optind is external, it is normally initialized to 
zero automatically before the first call to getopt . 


When all options have been processed (i.e., up to the first non- 
option argument), getopt returns EOF . The special option — may 
be used to delimit the end of ine options; EOF will be returned, and” > 
— will be skipped. 3 oat 


DIAGNOSTICS 
Getopt prints an error message on stderr and returns a question 
mark (?) when it encounters an option letter not included in opt- 
string . This error message may be disabled by setting opterr to a 
non-zero value. 


EXAMPLE 
The following code fragment shows how one might process the 
arguments for a command that can take the mutually exclusive 
options a and b , and the options f and o , both of which require 
arguments: 


main (argc, argv) 

int argc; 

char **argv; 

{ 
int Cc; 
extern char *optarg; 
extern int optind; 


while ((c = getopt(argc, argv, "abf:o:")) != EOF) 
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switch (c) { 
_ case ‘a’: 
ae if (bflg) 
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errfig+ +; 
else 


aflg+ +; 
break; 
case ’b’: 
if (aflg) 


errfig+ +; 
else 


bproc( ); 

break; 

case ’f’: 
ifile = optarg; 
break; 

case ‘0’: 
ofile = optarg; 
break; 

case '?’: 


errflg+ +; 
; } 
( | if (errflg) { | 


fprintf(stderr, “usage: . . . "); 
exit (2); 


for ( ; optind < argc; optind+ +) { 
} if (access(argv[optind], 4)) { 


SEE ALSO 


getopt(1) in the Sys5 UNIX User Reference Manual. 


( 
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NAME | 
getpass — read a password: 


SYNOPSIS ; a 
char *getpass (prompt) 
char *prompt; 


DESCRIPTION _ 

Getpass reads up to a newline or EOF from the file /dev/tty , after 
prompting on the standard error output with the null-terminated 
string prompt and disabling echoing. A pointer is returned to a 
null-terminated string of at most 8 characters. If /dev/tty cannot be 
opened, a NULL pointer is returned. An interrupt will terminate input 
and send an interrupt signal to the calling program before returning. 


FILES 
/dev/tty 


SEE ALSO 
crypt(3C). 
WARNING 
The above routine uses <stdio.h>, which causes it to increase the 
size of programs not otherwise using standard |/O, more than might 
be expected. pork 


The return value points to static data whose content is overwritten 
by each call. 
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NAME 
getpw — get name from UID 
SYNOPSIS 
int getpw (uid, buf) 
int uid; 
char +buf; 
DESCRIPTION 
Getpw searches the password file for a user id number that equals 
uid , copies the line of the password file in which uid was found into 
the array pointed to by buf, and returns 0. Getpw returns non-zero 
if uid cannot be found. 
This routine is included only for compatibility with prior systems and 
should not be used; see getpwent (3C) for routines to use instead. 
FILES 
/etc/passwd 
SEE ALSO 
getpwent(3C), passwd(4). 
DIAGNOSTICS 
Getpw returns non-zero on error. 
WARNING 


The above routine uses <stdio.h>, which causes it to increase, 
more than might be expected, the size of programs not otherwise 
using standard 1/O. 
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NAME 
getpwent, getpwuid, getpwnam, setpwent, endpwent, fgetpwent — a: 
get password file entry a — wy 
SYNOPSIS | | 


#include <pwd.h> 
struct passwd *getpwent ( ) 


struct passwd =getpwuid (uid) 
int uid; 


struct passwd *getpwnam (name) 


char +name; 
void setpwent ( ) | 
void endpwent ( ) 


struct passwd +*fgetpwent (f) 
FILE +f; 


DESCRIPTION 
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Getpwent , getowuid and getpwnam each returns a pointer to an 
object with the following structure containing the broken-out fields of 
a line in the /etc/passwd file. Each line in the file contains a 
“passwd” structure, declared in the <pwd.h> header file: ge 


struct passwd { ~ J 
char. *pw_name; 
char *pw_passwd; 
int pw_uid; 
int pw_gid; 
char *pw_age; 
char *pw_comment; 
char *pw_gecos; 
char *pw_dir; 
char *pw_shell; 
hi 
This structure is declared in <pwd.h> so it is not necessary to 
redeciare it. 


The pw_comment field is unused; the others have meanings 
described in passwd (4). 


Getpwent when first called returns a pointer to the first passwd 
structure in the file; thereafter, it returns a pointer to the next 
passwd structure in the file; so successive calls can be used to 
search the entire file. Getpwuid searches from the beginning of the 
file until a numerical user id matching uid is found and returns a‘ | 
pointer to the particular structure in which it was found. Getpwnam ~~ 


K 7 


searches from the beginning of the file until a login name matching 


name is found, and returns a pointer to the particular structure in 
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which it was found. If an end-of-file or an error is encountered on 
reading, these functions return a NULL pointer. 


A call to setowent has the effect of rewinding the password file to 
allow repeated searches. Endpwent may be called to close the 
password file when processing is complete. 


Fgetpwent returns a pointer to the next passwd structure in the 
stream f, which matches the format of /etc/passwd . 


FILES 
/etc/passwd 


SEE ALSO 
getlogin(3C), getgrent(3C), passwd(4). 

DIAGNOSTICS 
A NULL pointer is returned on EOF or error. 

WARNING 
The above routines use <stdio.h>, which causes them to increase 
the size of programs, not otherwise using standard |/O, more than 
might be expected. 

BUGS 


All information is contained in a static area, so it must be copied if it 
is to be saved. 
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NAME 


~SYNOP 


gets, fgets — get a string from astream 


SIS 


#include <stdio.h> 


char +gets (s) 
char +s; | 


char +fgets (s, n, stream) 
char +s; 

int n; | 

FILE +stream; 


DESCRIPTION 


Gets reads characters from the standard input stream, stdin, into 
the array pointed to by s , until a new-line character is read or an 
end-of-file condition is encountered. The new-line character is dis- 
carded and the string is terminated with a null character. 


Fgets reads characters from the stream into the array pointed to by 
Ss , until m —7 characters are read, or a new-line character is read 
and transferred to s , or an end-of-file condition is encountered. The 
string is then terminated with a null character. | 


SEE ALSO 


ferror(3S), fopen(3S), fread(3S), getc(3S), scanf(3S). 


DIAGNOSTICS 


— Page 1 


If end-of-file is encountered and no characters have been read, no 
characters are transferred to s and a NULL pointer is returned. If a 
read error occurs, such as trying to use these functions on a file that 
has not been opened for reading, a NULL pointer is returned. Other- 
wise s is returned. _ 
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NAME 
getutent, getutid, getutline, pututline, setutent, endutent, utmpname 
— access utmp file entry 
SYNOPSIS 
#include <utmp.h> 
struct utmp *getutent ( ) 
struct utmp +getutid (id) 
struct utmp +id; 
struct utmp *getutline (line) 
struct utmp line; 
void pututline (utmp) 
struct utmp *utmp; 
void setutent ( ) 
void endutent ( ) 
void utmpname (file) 
char file; | 
DESCRIPTION : 
Getutent , getutid and getutline each return a pointer to a structure 
of the following type: 
struct utmp { 
char ut_user[8]; /* User login name */ 
char ut_id[4]; /* fetc/inittab id 
* (usually line #) */ 
char ut_line[12]; /* device name (console, 
* Inxx) */ 
short ut_pid; /* process id */ 
short ut_type; /* type of entry */ 
struct exit_status { 
short e_termination; /* Process term’‘ion stat. */ 
short e_exit; /* Process exit stat. */ 
} ut_exit; /* The exit stat. of a process 
* mrk’'d DEAD_PROCESS. */ 
time_t ut_time; /* time entry was made */ 
}; 
Getutent reads in the next entry from a utmp -like file. If the file is 
not already open, it opens it. If it reaches the end of the file, it fails. 
Getutid searches forward from the current point in the utmp file until 
it finds an entry with a ut_type matching id—>ut_type if the type 
specified is RUN_LVL, BOOT_TIME, OLD_TIME or NEW_TIME. If the 
type specified in id is INIT.PROCESS, LOGIN_PROCESS, 
USER_PROCESS or DEAD_PROCESS, then getutid will return a 
pointer to the first entry whose type is one of these four and whose 
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FILES 


ut_id field matches id—>ut_id . |f the end of file is reached without a 
match, it fails. 


Getutline searches forward from the current point in the utmp file 
until it finds an entry of the type LOGIN_PROCESS or 
USER_PROCESS which also has a ut_line string matching the 
line—>ut_line string. If the end of file is reached without a match, it 
fails. 


Pututline writes out the supplied utmp structure into the utmp file. 
It uses getutid to search forward for the proper place if it finds that it 
is not already at the proper place. It is expected that normally the 
user of pututline will have searched for the proper entry using one 
of the getut routines. If so, pututline will not search. If pututline 
does not find a matching slot for the new entry, it will add a new 
entry to the end of the file. 


Setutent resets the input stream to the beginning of the file. This 
should be done before each search for a new entry if it is desired 
that the entire file be examined. 


Endutent closes the currently open file. 


Utmpname allows the user to change the name of the file exam- 
ined, from /etc/utmp to any other file. It is most often expected that 
this other file will be /etc/wtmp . If the file does not exist, this will 
not be apparent until the first attempt to reference the file is made. 
Utmpname does not open the file. It just closes the old file if it is 
currently open and saves the new file name. 


fetc/utmp 
fetc/wtmp 


SEE ALSO 


ttyslot(3C), utmp(4). 


DIAGNOSTICS 


A NULL pointer is returned upon failure to read, whether for permis- 
sions or having reached the end of file, or upon failure to write. 


COMMENTS 


The most current entry is saved in a static structure. Multiple 
accesses require that it be copied before further accesses are 
made. Each call to either getutid or getutline sees the routine 
examine the static structure before performing more V/O. If the con- 


tents of the static structure match what it is searching for, it looks no 


further. For this reason to use getutline to search for multiple 
occurrences, it would be necessary to zero out the static after each 
success, or getutline would just return the same pointer over and 
over again. There is one exception to the rule about removing the 
structure before further reads are done. The implicit read done by 
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pututline (if it finds that it is not already at the correct place in the 
file) will not hurt the contents of the static structure returned by the 
getutent , getutid or getutline routines, if the user has just modified 
those contents and passed the pointer back to pututiine . 


These routines use buffered standard VO for input, but pututline 
uses an unbuffered non-standard write to avoid race conditions 
between processes trying to modify the utmp and wtmp files. 
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NAME 


hsearch, hcreate, hdestroy — manage hash search tables -_ 


SYNOPSIS | _ 7 _ -— 
#include <search.h> : _ 3 


ENTRY +hsearch (item, action) 
ENTRY item; | 
ACTION action; 


int hcreate (nel) 
unsigned nel; 


void hdestroy ( ) 


DESCRIPTION 
Hsearch is a hash-table search routine generalized from Knuth (6.4) 
Algorithm D. It returns a pointer into a hash table indicating the 
location at which an entry can be found. /tem is a structure of type 
ENTRY (defined in the <search.h> header file) containing two 
pointers: item.key points to the comparison key, and item.data 
points to any other data to be associated with that key. (Pointers to 
types other than character should be cast to pointer-to-character.) 
Action is a member of an enumeration type ACTION indicating the 
disposition of the entry if it cannot be found in the table. ENTER —— 
indicates that the item should be inserted in the table at an appropri-. ) 
ate point. FIND indicates that no entry should be made. Unsuc- ~ ~ 
cessful resolution is indicated by the return of a NULL pointer. 


Hcreate allocates sufficient space for the table, and must be called 
before hsearch is used, Nel is an estimate of the maximum number 
of entries that the table will contain. This number may be adjusted 
upward by the algorithm in order to obtain certain mathematically 
favorable circumstances. 


Hdestroy destroys the search table, and may be followed by 
another call to Acreate . 


NOTES 
Hsearch uses open addressing with a multiplicative hash function. 
However, its source code has many other options available which 
the user may select by compiling the hsearch source with the fol- 
lowing symbols defined to the preprocessor: 


DIV Use the remainder modulo table size as the hash 
function instead of the multiplicative algorithm. 


USCR Use a User Supplied Comparison Routine for 
ascertaining table membership. The routine, » 
should be named hcompar and should behave in 
a mannner similar to strcmp (see string (3C)). 7 
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CHAINED Use a linked list to resolve collisions. If this 
option is selected, the following other options 
become available. 


START Place new entries at the beginning 
of the linked list (default is at the 
end). 


SORTUP Keep the linked list sorted by key in 
ascending order. 


SORTDOWN Keep the linked list sorted by key in 
descending order. 


Additionally, there are preprocessor flags for obtaining debugging 
printout (~DDEBUG) and for including a test driver in the calling rou- 
tine (-DDRIVER). The source code should be consulted for further 
details. | 


EXAMPLE 
The following example will read in strings followed by two numbers 
and store them in a hash table, discarding duplicates. It will then 
read in strings and find the matching entry in the hash table and 


print it out. 
, a #include <stdio.h> 
( #include <search.h> 
struct info { /« this is the info stored in the table »/ 
int age, room; /* other than the key. */ 
le 
#define NUM_EMPL 5000 #£«=(/* # of elements in srch tbl */ 
main( ) 
{ 


/* space to store strings */ | 
char string_space[NUM_EMPL*20]; 

/* space to store employee info */ 
struct info info_space[NUM_EMPL]; 

/* next avail space in string_space */ 
char *str_ptr = string_space; —— 
/* next avail space in info_space */ 
struct info *info_ptr = info_space; 
ENTRY item, *found_item, *hsearch( ); 
/* name to look for in table */ 
char name_to_find[30]; 


( 4 int i = 0; 


/* Create table «/ 
(void) hcreate(NUM_EMPL); 
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while (scanf("%s%d%d", str_ptr, &info_ptr->age, __ 

&info_ptr—>room) != EOF && i++ < % % 
| | NUM_EMPL) { edd 

/* put info in structure, and structure in item */ 

item.key = str_ptr; 

item.data = (char *)info_ptr; 

str_ptr += strlen(str_ptr) + 1; 

info_ptr+ +; 

/* put item into table */ 

(void) hsearch(item, ENTER); 


} 


/* access table ~/ 
item.key = name_to_find; 
while (scanf("%s", item.key) != EOF) { 
if ((found_item = hsearch(item, FIND)) != NULL) { 
/* if item is in the table */ 
(void)printf("found %s, age = %d, room = %d\n’, 
found_item—>key, — | 
((struct info *)found_item—>data)—> age, 
((struct info «)found_item—>data)—>room); 


} else { | ee 
(void)printf("no such employee %s\n", - 
name_to_find) ae” 
} 
} 
} 
SEE ALSO 
bsearch(3C), Isearch(3C), malloc(3C), malloc(3X),  string(3C), 
tsearch(3C). 
DIAGNOSTICS 


Hsearch returns a NULL pointer if either the action is FIND and the 
item could not be found or the action is ENTER and the table is full. 


Hcreate returns zero if it cannot allocate sufficient space for the 
table. 


WARNING 
Hsearch and hcreate use malloc (3C) to allocate space. 


BUGS 
Only one hash search table may be active at any given time. 


ae 
oN 
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NAME 
I3tol, Itol8 — convert between 3-byte integers and long integers 
SYNOPSIS 
void I3tol (Ip, cp, n) 
long +lp; 
char *cp; 
int n; 
void Itol3 (cp, Ip, n) 
char *cp; 
long lp; 
int n; 
DESCRIPTION | 
L3tol converts a list of n three-byte integers packed into a character 
string pointed to by cp into a list of long integers pointed to by /p . 
Ltol3 performs the reverse conversion from long integers (/p) to 
three-byte integers (cp). 
These functions are useful for file-system maintenance where the 
block numbers are three bytes long. 
SEE ALSO 
fs(4). 
BUGS 
Because of possible differences in byte ordering, the numerical 
values of the long integers are machine-dependent. 
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NAME 
lsearch, lfind — linear search and update 


SYNOPSIS 
#include <stdio.h> 
#include <search.h> 


char +*lsearch ((char +*)key, (char +*)base, nelp, sizeof(+key), 
compar) 

unsigned *nelp; 

int (*compar)( ); 


char +lIfind ((char *)key, (char +*)base, nelp, sizeof(+key), 
compar) 

unsigned +nelp; 

int (*compar)( ); 


DESCRIPTION 

Lsearch is a linear search routine generalized from Knuth (6.1) 
Algorithm S. It returns a pointer into a table indicating where a 
datum may be found. If the datum does not occur, it is added at the 
end of the table. Key points to the datum to be sought in the table. 
Base points to the first element in the table. Neip points to an 
integer containing the current number of elements in the table. The 
integer is incremented if the datum is added to the table. Compar 
is the name of the comparison function which the user must supply © 
(strcmp, for example). It is called with two arguments that point to 
the elements being compared. The function must return zero if the 
elements are equal and non-zero otherwise. 


Lfind is the same as /search except that if the datum is not found, it 
is not added to the table. Instead, a NULL pointer is returned. 


NOTES 
The pointers to the key and the element at the base of the table 
should be of type pointer-to-element, and cast to type pointer-to- 
character. 
The comparison function need not compare every byte, so arbitrary 
data may be contained in the elements in addition to the values 
being compared. 
Although declared as type pointer-to-character, the value returned 
should be cast into type pointer-to-element. 


EXAMPLE | 
This fragment will read in = TABSIZE strings of length = ELSIZE and 
store them in a table, eliminating duplicates. 


#include <stdio.h> 
#include <search.h> 


#define TABSIZE 50 
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#define ELSIZE 120 


char line[ELSIZE], tab[TABSIZE][ELSIZE], «lsearch( ); 
unsigned nel = 0; 
int stremp( ); 


while (fgets(line, ELSIZE, stdin) !'= NULL && 
nel < TABSIZE) 
(void) lsearch(line, (char *)tab, &nel, 
ELSIZE, strcmp); 


SEE ALSO 
bsearch(3C), hsearch(3C), tsearch(3C). 
DIAGNOSTICS 
lf the searched for datum is found, both /search and /find return a 
pointer to it. Otherwise, /find returns NULL and /search returns a 
pointer to the newly added element. 
BUGS , . 
Undefined results can occur if there is not enough room in the table 
to add a new item. 
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NAME 


- malloc, free, realloc, calloc - main memory allocator 
SYNOPSIS 


char +malloc (size) 
unsigned size; 


void free (ptr) 

char =ptr; 

char +realloc (ptr, size) 
char +ptr; | 
unsigned size; 


char *calloc (nelem, elsize) 
unsigned nelem, elsize; 


DESCRIPTION 
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Malloc and free provide a simple general-purpose memory alloca- 
tion package. Malloc returns a pointer to a block of at least size 
bytes suitably aligned for any use. 


The argument to free is a pointer to a block previously allocated by 
malloc ; after free is performed this space is made available for 
further allocation, but its contents are left undisturbed. 


Undefined results will occur if the space assigned by malloc is over- . 


run or if some random number is handed to free . 


Malloc allocates the first big enough contiguous reach of free space 
found in a circular search from the last block allocated or freed, 
coalescing adjacent free blocks as it searches. It calls sbrk (see 
brk (2)) to get more memory from the system when there is no suit- 
able space already free. 


Realfoc changes the size of the block pointed to by pir to size 
bytes and returns a pointer to the (possibly moved) block. The con- 
tents will be unchanged up to the lesser of the new and old sizes. If 
no free block of size bytes is available in the storage arena, then 
realloc will ask malloc to enlarge the arena by size bytes and will 
then move the data to the new space. 


Realloc also works if ptr points to a block freed since the last call of 
malloc , realloc , or calloc ; thus sequences of free , malloc and 
realloc can exploit the search strategy of malioc to do storage com- 
paction. 


Calloc allocates space for an array of nelem elements of size elsize 
. The space is initialized to zeros. 
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Each of the allocation routines returns a pointer to space suitably 
aligned (after possible pointer coercion) for storage of any type of 
object. 


SEE ALSO 
brk(2), malloc(3X). 


DIAGNOSTICS 
Malloc , realloc and calloc return a NULL pointer if there is no avail- 
able memory or if the arena has been detectably corrupted by stor- 
ing outside the bounds of a block. When this happens the block 
pointed to by ptr may be destroyed. 


NOTE 
Search time increases when many objects have been allocated; that 
is, if a program allocates but never frees, then each successive allo- 
cation takes longer. For an alternate, more flexible implementation, 
see malloc (3X). 


May 22, 1985 Page 2 


MEMORY (3C) UNIX Sys5 MEMORY(3C) 


NAME 


memccpy, memchr, memcmp, memcpy, memset — memory opera- 
tions 


SYNOPSIS 


#include <memory.h> 


char *memccpy (s1, $2, c, n) 
char *s1, *s2; 
int c, n; 


char *«memchr (s, c, n) 
char *s; 
int c, n; 


int memcmp (s1, s2, n) 
char «si, *s2; | 
int n; 


char «memcpy (s1, s2, n) 
char *s1, *S2; 

int n; 

char «memset (S, c, n) 
char *s; 

int c, n; 


DESCRIPTION 
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These functions operate as efficiently as possible on memory areas 
(arrays of characters bounded by a count, not terminated by a null 
character). They do not check for the overflow of any receiving 
memory area. 


Memccpy copies characters from memory area s2 into $1 , stop- 
ping after the first occurrence of character ¢ has been copied, or 
after n characters have been copied, whichever comes first. It 
returns a pointer to the character after the copy of c in s1, ora 
NULL pointer if c was not found in the first n characters of $2. 


Memchr returns a pointer to the first occurrence of character ¢ in 
the first n characters of memory area s, or a NULL pointer if ¢ does 
not occur. 


Memcmp compares its arguments, looking at the first n characters 
only, and returns an integer less than, equal to, or greater than 0, 
according as $1 is lexicographically less than, equal to, or greater 
than s2. | 


Memcpy copies n characters from memory area s2 to si. It, 


returns $1. 
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Memset sets the first n characters in memory area s to the value of 
character c. It returns s. 


NOTE | 
For user convenience, all these functions are declared in the 
optional <memory.h> header file. | 


BUGS 
Memcmp uses native character comparison, which is unsigned on 
other machines. Thus the sign of the value returned when one of 
the characters has its high-order bit set is implementation- 
dependent. 


Character movement is performed differently in different implemen- 
tations. Thus overlapping moves may yield surprises. 
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NAME 
mktemp — make a unique file name 


SYNOPSIS 
char *«mktemp (template) 
char *template; 


DESCRIPTION 
Mktemp replaces the contents of the string pointed to by template 
by a unique file name, and returns the address of template . The 
string in template should look like a file name with six trailing X s; 
mktemp will replace the X s with a letter and the current process ID. 
The letter will be chosen so that the resulting name does not dupli- 
cate an existing file. 


SEE ALSO 
getpid(2), tmpfile(3S), tmpnam(3S). 


BUGS 
It is possible to run out of letters. 
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NAME 


monitor — prepare execution profile 


SYNOPSIS 


#include <mon.h> 


void monitor (lowpe, highpc, buffer, bufsize, nfunc) 
int (slowpc)( ), (*highpc)( ); 

WORD «buffer; 

int bufsize, nfunc; 


DESCRIPTION 


An executable program created by cc -p automatically includes 
calls for monitor with default parameters; monitor needn't be called 
explicitly except to gain fine control over profiling. 


Monitor is an interface to profil (2). Lowpc and highpc two function 
addresses; buffer is the address of a (user supplied) array of buf- 
size WORDs (defined in the <mon.h> header file). Monitor records 
a histogram of periodically sampled values of the program counter, 
and of counts of certain function calls, in the buffer. The lowest 
address sampled is that of jowpc and the highest is just below 
highpc. \|n this case, lowpc may not equal 0. At most, nfunc call 
counts can be kept; only calls of functions compiled with the profiling 
option —p of cc (7) are recorded. (The C Library and Math Library 
supplied when cc —p is used also have call counts recorded.) 


For the results to be significant, especially where there are small, 
heavily used routines, it is suggested that the buffer be no more 
than a few times smaller than the range of locations sampled. 


To profile the entire program, it is sufficient to use 
extern etext; 


monitor ((int (*)())2, etext, buf, bufsize, nfunc); 
Etext lies just above all the program text; see end (3C). 


To stop execution monitoring and write the results on the file 
mon.out , use 


monitor ((int (*)())O, 0, 0, O, 0); 
Prof (1) can then be used to examine the results. 


FILES 
mon.out 
Nib/libp/libc.a 

( , Mib/ibp/libm.a 
.. SEE ALSO 

profil(2), end(3C). | 
cc(1), prof(1) in the Sys5 UNIX User Reference Manual. 

Page 1 August 20, 1986 


NLIST(3C) | UNIX Sys5 NLIST(3C) 


NAME 


nlist — get entries from name list 


SYNOPSIS 


#include <nlist.h> 


int nlist (file-name, nl) 
char +file-name; 
struct nlist «nl; 


DESCRIPTION 


NOTES 


Nlist examines the name list in the executable file whose name is 
pointed to by file-name , and selectively extracts a list of values and 
puts them in the array of nlist structures pointed to by ni. The name 
list n/ consists of an array of structures containing names of vari- 
ables, types and values. The list is terminated with a null name; 
that is, a null string is in the name position of the structure. Each 
variable name is looked up in the name list of the file. If the name is 
found, the type and value of the name are inserted in the next two 
fields. The type field will be set to 0 unless the file was compiled 
with the —g option. If the name is not found, both entries are set to 
0. See a.out (4) for a discussion of the symbol table structure. 


This function is useful for examining the system name list kept in the 
file /unix . In this way programs can obtain system addresses that 
are up to date. | 


The <nilist.h> header file is automatically included by <a.out.h> 
for Compatability. However, if the only information needed from 
<a.outh> is for use of niist , then including <a.out.h> Is 
discouraged. If <a.out.h> is included, the line “#undef n_name’ 
may need to follow it. 


SEE ALSO 


a.out(4). 


DIAGNOSTICS 
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All vaiue entries are set to 0 if the file cannot be read or if it does 
not contain a valid name list. 


Nlist returns —1 upon error; otherwise it returns 0. 
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NAME fo™ 
perror, errno, sys_errlist, sys_nerr — system error messages Cw 
SYNOPSIS | 
void perror (s) 
char *s; 


extern int errno; 
extern char *sys_errlist[ ]; 
extern int sys_nerr; 


DESCRIPTION | | 
a Perror produces a message on the standard error output, describing 
the last error encountered during a call to a system or library func- 
tion. The argument string s is printed first, then a colon and a 
blank, then the message and a new-line. To be of most use, the 
argument string should include the name of the program that 
incurred the error. The error number is taken from the external vari- 
_able errno , which is set when errors occur but not cleared when 
non-erroneous calls are made. — 


To simplify variant formatting of messages, the array of message 
strings sys_errlist is provided; errno can be used as an index in this 
table to get the message string without the new-line. Sys_nerr is | 
the largest message number provided for in the table; it should be \ _” 
checked because new error codes may be added to the system 
before they are added to the table. 


SEE ALSO 
intro(2). 
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NAME 


popen, pclose — initiate pipe to/from a process 


SYNOPSIS 


#include <stdio.h> 
FILE *popen (command, type) 
char *«command, +*type; 


int pclose (stream) 
FILE «stream; 


DESCRIPTION 


The arguments to popen are pointers to null-terminated strings con- 
taining, respectively, a shell command line and an |/O mode, either r 
for reading or w for writing. Popen creates a pipe between the cal- 
ling program and the command to be executed. The value returned 
is a stream pointer such that one can write to the standard input of 
the command, if the I/O mode is w, by writing to the file stream; and 
one can read from the standard output of the command, if the I/O 
mode is r, by reading from the file stream. 


A stream opened by popen should be closed by pclose, which 
waits for the associated process to terminate and returns the exit 
status of the command. | 


Because open files are shared, a type r command may be used as 
an input filter and a type w as an output filter. 


SEE ALSO 


pipe(2), wait(2), fclose(3S), fopen(3S), system(3S). 


DIAGNOSTICS | 


BUGS 


Popen returns a NULL pointer if files or processes cannot be © 
created, or if the shell cannot be accessed. 


Pclose returns —1 if stream is not associated with a “popened’ 
command. 


If the original and “popened” processes concurrently read or write a 
common file, neither should use buffered I/O, because the buffering 
gets all mixed up. Problems with an output filter may be forestalled 


_ by careful buffer flushing, e.g. with fflush; see fclose (3S). 
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NAME 


printf, fprintf, sprintf — print formatted output 


SYNOPSIS 


#include <stdio.h> 


int printf (format [ , arg]... ) 
char +format; 


int fprintf (stream, format [, arg]... ) 
FILE +stream; 
char +*format; 


int sprintf (s, format [, arg]... ) 
char +*s, format; 


DESCRIPTION 
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Printf places output on the standard output stream stdout. Foprintf 


places output on the named output stream. Sprintf places “output,” — 


followed by the null character (\0), in consecutive bytes starting at 
*§; it is the user’s responsibility to ensure that enough storage is 
available. Each function returns the number of characters transmit- 
ted (not including the \0 in the case of sprintf), or a negative value if 
an output error was encountered. 


Each of these functions converts, formats, and prints its args under ~~ 


control of the format. The format is a character string that contains 
two types of objects: plain characters, which are simply copied to 
the output stream, and conversion specifications, each of which 
results in fetching of zero or more args. The results are undefined if 
there are insufficient args for the format. If the format is exhausted 
while args remain, the excess args are simply ignored. 


Each conversion specification is introduced by the character %. 
After the %, the following appear in sequence: 


Zero or more flags, which modify the meaning of the 
conversion specification. 


An optional decimal digit string specifying a minimum field 
width. \f the converted value has fewer characters than the 
field width, it will be padded on the left (or right, if the left- 
adjustment flag ‘~’, described below, has been given) to the 
field width. If the field width for an s conversion is preceded 
by a 0, the string is right adjusted with zero-padding on the 
left. 


A precision that gives the minimum number of digits to 
appear for the d, 0, u, x, or X conversions, the number of 
digits to appear after the decimal point for the e and f 
conversions, the maximum number of significant digits for 
the g conversion, or the maximum number of characters to 
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be printed from a string in $s conversion. The precision 
takes the form of a period (.) followed by a decimal digit 
string; a null digit string is treated as zero. 


An optional I (ell) specifying that a following d, 0, u, x, or X 
conversion character applies to a long integer arg. A | 
before any other conversion character is ignored. 


A character that indicates the type of conversion to be 
applied. 


A field width or precision may be indicated by an asterisk (*) instead 
of a digit string. In this case, an integer arg supplies the field width 
or precision. The arg that is actually converted is not fetched until 
the conversion letter is seen, so the args specifying field width or 
precision must appear before the arg (if any) to be converted. 


The flag characters and their meanings are: 
- The result of the conversion will be left-justified within the 


field. | 

+ The result of a signed conversion will always begin with 
a sign (+ or -). | 

blank lf the first character of a signed conversion is not a sign, 


a blank will be prefixed to the result. This implies that if 

( the blank and + flags both appear, the blank flag will be 

" ignored. 

# This flag specifies that the value is to be converted to an 
“alternate form.” For c, d, s, and u conversions, the flag 
has no effect. For 0 conversion, it increases the preci- 
sion to force the first digit of the result to be a zero. For 
x or X conversion, a non-zero result will have Ox or OX 
prefixed to it. For e, E, f, g, and G conversions, the 
result will always contain a decimal point, even if no 
digits follow the point (normally, a decimal point appears 
in the result of these conversions only if a digit follows it). 
For g and G conversions, trailing zeroes will not be 
removed from the result (which they normally are). 


The conversion characters and their meanings are: 


d,o,u,x,x The integer arg is converted to signed decimal, unsigned 

octal, decimal, or hexadecimal notation (x and X), 

respectively; the letters abcdef are used for x conversion 

and the letters ABCDEF for X conversion. The precision 

specifies the minimum number of digits to appear; if the 

_ value being converted can be represented in fewer 
{ ; digits, it will be expanded with leading zeroes. (For com- 
= patibility with older versions, padding with leading zeroes 
may alternatively be specified by prepending a zero to 

the field width. This does not imply an octal vaiue for the 
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field width.) The default precision is 1. The result of con- o~ 
verting a zero value with a precision of zero is a null | 
string. 7 

f The float or double arg is converted to decimal notation 
in the style “[—]ddd.ddd,” where the number of digits 
after the decimal point is equal to the precision specifica- 
tion. If the precision is missing, six digits are output; if 
the precision is explicitly 0, no decimal point appears. 

e,E The float or double arg is converted in the style 

—_ “[-]d.ddde+dd,” where there is one digit before the 
decimal point and the number of digits after it is equal to 
the precision; when the precision is missing, six digits 
are produced; if the precision is zero, no decimal point 
appears. The E format code will produce a number with 
E instead of e introducing the exponent. The exponent 

| always contains at least two digits. 

g,G The float or double arg is printed in style f or e (or in 
style E in the case of a G format code), with the preci- 
sion specifying the number of significant digits. The style 
used depends on the value converted: style e will be 
used only if the exponent resulting from the conversion is 
less than —4 or greater than the precision. Trailing ~~ 
zeroes are removed from the result; a decimal point. | 
appears only if it is followed by a digit. - 

Cc The character arg is printed. 

s The arg is taken to be a string (character pointer) and 
characters from the string are printed until a null charac- 
ter (\O) is encountered or the number of characters indi- 
cated by the precision specification is reached. If the 
precision is missing, it is taken to be infinite, so all char- 

~acters up to the first null character are printed. A NULL 
value for arg will yield undefined results. 

% Print a %; No argument is converted. 


In no case does a non-existent or small field width cause truncation 
of a field; if the result of a conversion is wider than the field width, 
the field is simply expanded to contain the conversion result. Char- 
acters generated by printf and fprintf are printed as if putc(3S) had 
been called. 


EXAMPLES 
To print a date and time in the form “Sunday, July 3, 10:02,” where 
weekday and month are pointers to null-terminated strings: 7 
printf("%s, %S %d, %d:%.2d", weekday, month, day, hour, nv 


“A 


To print 7 to 5 decimal places: 
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printf("pi = %.5f", 4 * atan(1.0)); 


( SEE ALSO 
- ecvt(3C), putc(3S), scanf(3S), stdio(3S). 
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NAME 


putc, putchar, fputc, putw 2 put character or word on a stream 


SYNOPSIS | Se ae 4 
#include <stdio.h> 


int putc (c, stream) 
int c; 
FILE stream; 


int putchar (c) 
int c; 
int fputc (c, stream) 
int c; 
FILE +stream; 
int putw (w, stream) 
int w; 
FILE *stream; 
DESCRIPTION 
Putc writes the character c onto the output stream (at the position 
where the file pointer, if defined, is pointing). Putchar(c) is defined 
as putc(c, stdout). Putc and putchar are macros. 


Fputc behaves like putc, but is a function rather than a macro. > 
Fputc runs more slowly than putc, but it takes less space per invo- <= ~” 
cation and its name can be passed as an argument to a function. 


Putw writes the word (i.e. integer) w to the output stream (at the 
position at which the file pointer, if defined, is pointing). The size of 
a word is the size of an integer and varies from machine to 
machine. Putw neither assumes nor causes special alignment in 
the file. 


Output streams, with the exception of the standard error stream 
stderr, are by default buffered if the output refers to a file and line- 
buffered if the output refers to a terminal. The standard error output _ 
stream stderr is by default unbuffered, but use of freopen (see 
fopen(3S)) will cause it to become buffered or line-buffered. When 

an output stream is unbuffered, information is queued for writing on 

the destination file or terminal as soon as written; when it is buf- 
fered, many characters are saved up and written as a block. When 

it is line-buffered, each line of output is queued for writing on the 
destination terminal as soon as the line is completed (that is, as 
soon as a new-line character is written or terminal input is 
requested). Setbuf(3S) or Setbuf(3S) may be used to change the ,- 
stream’s buffering strategy. 
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SEE ALSO 
fclose(3S), ferror(3S), fopen(3S), fread(3S), printf(3S), puts(3S), 
setbuf(3S). 


DIAGNOSTICS 
On success, these functions each return the value they have writ- 
ten. On failure, they return the constant EOF . This will occur if the 
file stream is not open for writing or if the output file cannot be 
grown. Because EOF is a valid integer, ferror (3S) should be used 
to detect putw errors. 


BUGS 
Because it is implemented as a macro, putc treats incorrectly a 
stream argument with side effects. In particular, putc(c, +f+ +); 
doesn't work sensibly. Fpoutc should be used instead. 
Because of possible differences in word length and byte ordering, 
files written using putw are machine-dependent, and may not be 
read using getw on a different processor. 
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NAME 
putenv — change or add value to environment 


SYNOPSIS 
int putenv (string) 
char *string; 


DESCRIPTION 
String points to a string of the form ‘‘name =value.’’ Putenv makes 
the value of the environment variable name equal to value by alter- 
ing an existing variable or creating a new one. In either case, the 
string pointed to by string becomes part of the environment, so 
altering the string will change the environment. The space used by 
string is no longer used once a new string-defining name is passed 
to putenv . | 


DIAGNOSTICS 
Putenv returns non-zero if it was unable to obtain enough space via 
malloc for an expanded environment, otherwise zero. 


SEE ALSO 
exec(2), getenv(3C), malloc(3C), environ(5). 


WARNINGS 


ment to main ) is not changed. 

This routine uses malloc (3C) to enlarge the environment. 

After putenv is called, environmental variables are not in alphabeti- 
cal order. 

A potential error is to call putenv with an automatic variable as the 
argument, then exit the calling function while string is still part of the 
environment. 
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be used in conjunction with getenv. However, envp (the third argu- . 
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--. NAME 
( putpwent — write password file entry 


SYNOPSIS 
#include <pwd.h> 


int putpwent (p, f) 
struct passwd <p; 
FILE +f; 


DESCRIPTION 
Putpwent is the inverse of getowent (3C). Given a pointer to a 
passwd structure created by gefpwent (or getpwuid or getownam 
), putpwent writes a line on the stream f, which matches the format 
of /etc/passwd . 


DIAGNOSTICS 
Putpwent returns non-zero if an error was detected during its opera- 
tion, otherwise zero. 


SEE ALSO 
getpwent(3C). 


WARNING 
_ The above routine uses <stdio.h>, which causes it to increase the 
( size of programs, not otherwise using standard I/O, more than might 
be expected. 
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NAME EN 
puts, fouts — put a string on a stream : | 


SYNOPSIS 
#include <stdio.h> 
int puts (s) 
char *s; 
int fputs (s, stream) | 
char *s; | 
FILE *stream; 
DESCRIPTION 


Puts writes the null-terminated string pointed to by s , followed by a 
new-line character, to the standard output stream stdout. 


Fouts writes the null-terminated string pointed to by s to the named 
output stream . 


Neither function writes the terminating null character. 


DIAGNOSTICS : | | 
Both routines return EOF on error. This will happen if the routines try 
to write on a file that has not been opened for writing. | 


SEE ALSO -_ 
ferror(3S), fopen(3S), fread(3S), printf(3S), putc(3S). oe 


NOTES 
Puts appends a new-line character while fouts does not. 
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NAME 


qsort — quicker sort 


SYNOPSIS 


void qsort ((char «) base, nel, sizeof (*base), compar) 
unsigned nel; 
int (*compar){ ); 


DESCRIPTION 


NOTES 


Qsort is an implementation of the quicker-sort algorithm. It sorts a 
table of data in place. 


Base points to the element at the base of the table. Nel is the 
number of elements in the table. Compar is the name of the com- 
parison function, which is called with two arguments that point to the 
elements being compared. As the function must return an integer 
less than, equal to, or greater than zero, so must the first argument 
to be considered be less than, equal to, or greater than the second. 


The pointer to the base of the table should be of type pointer-to- 
element, and cast to type pointer-to-character. 

The comparison function need not compare every byte, so arbitrary 
data may be contained in the elements in addition to the values 
being compared. 

The order in the output of two items which compare as equal is 
unpredictable. 


SEE ALSO 
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bsearch(3C), lsearch(3C), string(3C). 
sort(1) in the Sys5 UNIX User Reference Manual. 
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NAME eN 
rand, srand — simple random-number generator Le 
Wate ote 
SYNOPSIS 
int rand ( ) 


void srand (seed) 
unsigned seed; 


DESCRIPTION 
Rand uses a multiplicative congruential random-number generator 
with period 237 that returns successive pseudo-random numbers in 
the range from 0 to Zee 


Ssrand can be called at any time to reset the random-number gen- 
erator to a random starting point. The generator is initially seeded 
with a value of 1. 


NOTE 
The spectral properties of rand leave a great deal to be desired. 
Drand48 (3C) provides a much better, though more elaborate, 
random-number generator. 
SEE ALSO 
drand48(3C). ~ 
—_ 
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NAME 


scanf, fscanf, sscanf — convert formatted input 


SYNOPSIS 


#include <stdio.h> 


int scanf (format [ , pointer]... ) 
char +format; 


int fscanf (stream, format [ , pointer]... ) 
FILE +stream; 
char +format; 


int sscanf (s, format [ , pointer]... ) 
char +s, *format; 


DESCRIPTION 


Page 1 


Scanf reads from the standard input stream stdin. Fscanf reads 
from the named input sfream. Sscanf reads from the character 
string s. Each function reads characters, interprets them according 
to a format, and stores the results in its arguments. Each expects, 
as arguments, a control string format described below, and a set of 
pointer arguments indicating where the converted input should be 
stored. 


The control string usually contains conversion specifications, which 
are used to direct interpretation of input sequences. The control 
string may contain: 


1. White-space characters (blanks, tabs, new-lines, or form-feeds) 
_which, except in two cases described below, cause input to be 
read up to the next non-white-space character. 

2. An ordinary character (not %), which must match the next char- 
acter of the input stream. 

3. Conversion specifications, consisting of the character %, an 
optional assignment suppressing character +, an optional numer- 
ical maximum field width, an optional | (ell) or h indicating the 
size of the receiving variable, and a conversion code. 


A conversion specification directs the conversion of the next input 
field; the result is placed in the variable pointed to by the 
corresponding argument, unless assignment suppression was indi- 
cated by +. The suppression of assignment provides a way of 
describing an input field which is to be skipped. An input field is 
defined as a string of non-space characters; it extends to the next 
inappropriate character or until the field width, if specified, is 
exhausted. For all descriptors except “[’” and “c’, white space lead- 
ing an input field is ignored. 


The conversion code indicates the interpretation of the input field; 
the corresponding pointer argument must usually be of a restricted 
type. For a suppressed field, no pointer argument is given. The 
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following conversion codes are legal: 


% 


d 


e,f.g 
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a single % is expected in the input at this point; no oo 


ment is done. 

a decimal integer is expected; the corresponding atgument 
should be an integer pointer. 

an unsigned decimal integer is expected; the corresponding 
argument should be an unsigned integer pointer. 

an octal integer is expected; the corresponding argument 
should be an integer pointer. 

a hexadecimal integer is expected; the corresponding argu- 
ment should be an integer pointer. 

a floating point number is expected; the next field is con- 
verted accordingly and stored through the corresponding 
argument, which should be a pointer to a float. The input 
format for floating point numbers is an optionally signed 
string of digits, possibly containing a decimal point, followed 
by an optional exponent field consisting of an E or an e, fol- 
lowed by an optional +, —, or space, followed by an integer. 
a character string is expected; the corresponding argument 
should be a character pointer pointing to an array of charac- 
ters large enough to accept the string and a terminating \0, 


which will be added automatically. The input field is ter- ~~ 


minated by a white-space character. 


a character is expected; the corresponding argument should 


be a character pointer. The normal skip over white space is 
suppressed in this case; to read the next non-space charac- 
ter, use %1s. If a field width is given, the corresponding 
argument should refer to a character array; the indicated 
number of characters is read. 

indicates string data and the normal skip over leading white 
space is suppressed. The left bracket is followed by a set 
of characters, which we will call the scanset, and a right 
bracket; the input field is the maximal sequence of input 
characters consisting entirely of characters in the scanset. 
The circumflex (*), when it appears as the first character in 
the scanset, serves as a complement operator and rede- 
fines the scanset as the set of all characters not contained 
in the remainder of the scanset string. There are some con- 
ventions used in the construction of the scanset. A range of 
characters may be represented by the construct firstHast, 
thus [0123456789] may be expressed [0—9]. Using this 
convention, first must be lexically less than or equal to /ast, 


stand for itself whenever it is the first or the last character in 
the scanset. To include the right square bracket as an ele- 
ment of the scanset, it must appear as the first character 
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or else the dash will stand for itself. The dash will also,” > 
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(possibly preceded by a circumflex) of the scanset, and in 
( this case it will not be syntactically interpreted as the closing 
| bracket. The corresponding argument must point to a char- 
acter array large enough to hold the data field and the ter- 
minating \0, which will be added automatically. At least one 
character must match for this conversion to be considered 

successful. 


The conversion characters d, u, 0, and x may be preceded by | or h 
to indicate that a pointer to long or to short rather than to int is in 
the argument list. Similarly, the conversion characters e, f, and g 
may be preceded by I to indicate that a pointer to double rather 
than to float is in the argument list. The | or h modifier is ignored 
for other conversion characters. 


Scanf conversion terminates at EOF, at the end of the control string, 
or when an input character conflicts with the control string. In the 
latter case, the offending character is left unread in the input stream. 


Scanf returns the number of successfully matched and assigned 
input items; this number can be zero in the event of an early conflict 
between an input character and the control string. If the input ends 
before the first conflict or conversion, EOF is returned. 


( ~ EXAMPLES 
The call: 


int i, n; float x; char name[50}; 
n = scant ("%d%f%s", &i, &x, name); 


with the input line: 
25 54.32E—1 thompson 


will assign to n the value 3, to / the value 25, to x the value 5.432, 
and name will contain thompson\0. Or: 


int i; float x; char name[5SO]; 
(void) scant ("%2d%f%*d %[0-9]", &i, &x, name); 


with input: 
56789 0123 56a72 


will assign 56 to /, 789.0 to x, skip 0123, and place the string 56\0 
inname. The next call to getchar (see getc(3S)) will return a. 


SEE ALSO 
getc(3$), printf(3S), strtod(3C), strtol(3C). 


_. NOTE 
( | Trailing white space (including a new-line) is left unread unless 
NE matched in the control string. 
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DIAGNOSTICS 
These functions return EOF on end of input and a short count for 
missing or illegal data items. 


BUGS 
The success of literal matches and suppressed assignments is not 
directly determinable. 
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NAME 
setbuf, setvbuf — assign buffering to a stream 


— ' SYNOPSIS 
#include <stdio.h> 


void setbuf (stream, buf) 
FILE +stream; 
char +*buf; 


int setvbuf (stream, type, buf, size) 
FILE *stream; 

char buf; 

int type, size; 


DESCRIPTION 
Setbuf may be used after a stream has been opened but before it is 
read or written. It causes the array pointed to by buf to be used 
instead of an automatically allocated buffer. If buf is the NULL 
pointer input/output will be completely unbuffered. 


A constant BUFSIZ, defined in the <stdio.h> header file, tells how 
big an array is needed: 


char buf[BUFSIZ]; 


( | Setvbuf may be used after a stream has been opened but before it 
is read or written. Type determines how stream will be buffered. 
Legal values for type (defined in stdio.h) are: 


_IOFBF Causes input/output to be fully buffered. 


_IOLBF causes output to be line buffered; the buffer will be 
flushed when a newline is written, the buffer is full, or 
input is requested. 


_IONBF Causes input/output to be completely unbuffered. 


lf buf is not the NULL pointer, the array it points to will be used for 
buffering, instead of an automatically allocated buffer. Size speci- 
fies the size of the buffer to be used. The constant BUFSIZ in 
<stdio.h> is suggested as a good buffer size. If input/output is 
unbuffered, buf and size are ignored. 


By default, output to a terminal is line buffered and all other 
input/output is fully buffered. 


SEE ALSO 
fopen(3S), getc(3S), malloc(3C), putc(3S), stdio(3S). 
. DIAGNOSTICS 
( r If an illegal value for type or size is provided, setvbuf returns a 
— non-zero value. Otherwise, the value returned will be zero. 
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NOTE 
A common source of error is allocating buffer space as an ~ ~ 


“automatic” variable in a code block, and then failing to close the | 
stream in the same block. 
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_ NAME 


setimp, longjmp — non-local goto 


SYNOPSIS 


#include <setjmp.h> 


int setjmp (env) 
jmp_buf env; 
void longjmp (env, val) 


jmp_buf env; 
int val; 


DESCRIPTION 


These functions are useful for dealing with errors and interrupts 
encountered in a low-level subroutine of a program. 


Setimp saves its stack environment in env (whose type, jmp_buf , 
is defined in the <setjmp.h> header file) for later use by longjmp . 
It returns the value 0. 


Longjmp restores the environment saved by the last call of setjmp 
with the corresponding env argument. After fongjmp is completed, 
program execution continues as if the corresponding call of setjmp 
(which must not itself have returned in the interim) had just returned 
the value val . Longjmp cannot cause setjmp to return the value 0. 
If longjmp is invoked with a second argument of 0, setjmp will 
return 1. All accessible data had values as of the time jongjmp was 
called. 


SEE ALSO 


signal(2). 


WARNING 
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If fongjmp is called even though env was never primed by a call to 
setimp , or when the last such call was in a function which has 
since returned, absolute chaos is guaranteed. 
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NAME 


sleep — suspend execution for interval 


SYNOPSIS 


unsigned sleep (seconds) 
unsigned seconds; 


DESCRIPTION | 


The current process is suspended from execution for the number of 
seconds specified by the argument. The actual suspension time 
may be less than that requested for two reasons: (1) Because 
scheduled wakeups occur at fixed 1-second intervals, (on the 
second, according to an internal clock) and (2) because any caught 
signal will terminate the s/eep following execution of that signal's 
catching routine. Also, the suspension time may be longer than 
requested by an arbitrary amount due to the scheduling of other 
activity in the system. The value returned by s/eep will be the 
“unslept” amount (the requested time minus the time actually slept) 
in case the caller had an alarm set to go off earlier than the end of 
the requested s/eep time, or premature arousal due to another 
caught signal. 


The routine is implemented by setting an alarm signal and pausing 


until it (or some other signal) occurs. The previous state of the ~~ 


alarm signal is saved and restored. The calling program may have | 


set up an alarm signal before calling sleep . If the sleep time 
exceeds the time till such alarm signal, the process sleeps only until 
the alarm signal would have occurred. The caller's alarm catch rou- 
tine is executed just before the s/eep routine returns. But if the 
sleep time is less than the time till such alarm, the prior alarm time 
is reset to go off at the same time it would have without the inter- 
vening sleep . 


SEE ALSO 
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alarm(2), pause(2), signal(2). 
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NAME 
( ssignal, gsignal — software signals 


_. SYNOPSIS 
#include <signal.h> 


int (+ssignal (sig, action))( ) 
int sig, (*action)( ); 


int gsignal (sig) 
int sig; 

DESCRIPTION 
Ssignal and gsigna/l implement a software facility similar to sig- 
nal(2). This facility is used by the Standard C Library to enable 
users to indicate the disposition of error conditions, and is also 
made available to users for their own purposes. 


Software signals made available to users are associated with 
integers in the inclusive range 1 through 15. A call to ssignal associ- 
ates a procedure, action, with the software signal sig; the software 
signal, sig, is raised by a call to gsignal. Raising a software signal 
causes the action established for that signal to be taken. 


The first argument to ssignal is a number identifying the type of sig- 
Be. nal for which an action is to be established. The second argument 
( defines the action; it is either the name of a (user-defined) action 
function or one of the manifest constants SIG_DFL (default) or 
SIG_IGN (ignore). Ssigna/ returns the action previously established 
for that signal type; if no action has been established or the signal 

number is illegal, ssigna/ returns SIG_DFL. 


Gsignal raises the signal identified by its argument, sig: 


If an action function has been established for sig, then that 
action is reset to SIG_DFL and the action function is entered 
with argument sig. Gsignal returns the value returned to it by 
the action function. 


If the action for sig is SIG_IGN, gsignal/ returns the value 1 and 
takes no other action. 


If the action for sig is SIG_DFL, gsignal returns the value 0 
and takes no other action. 


If sig has an illegal value or no action was ever specified for 
Sig, gsignal returns the value 0 and takes no other action. 


SEE ALSO 
signal(2). 


( NOTES 
aa There are some additional signals with numbers outside the range 1 
through 15 which are used by the Standard C Library to indicate 


Page 1 May 13, 1986 


SSIGNAL(3C) UNIX Sys5 SSIGNAL(3C) 


error conditions. Thus, some signal numbers outside the range 1 
through 15 are legal, although their use may interfere with the ~< 
operation of the Standard C Library. \ 
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NAME 


stdio — standard buffered input/output package 


SYNOPSIS 


#include <stdio.h> 
FILE «stdin, «stdout, *stderr; 


DESCRIPTION 


The functions described in the entries of sub-class 3S of this manual 
constitute an efficient, user-level /O buffering scheme. The in-line 
macros getc(3S) and putc(3S) handle characters quickly. The 
macros getchar and putchar, and the higher-level routines fgetc, 
fgets, fprintf, fputc, fputs, fread, fscanf, fwrite, gets, getw, printf, 
puts, putw, and scanf all use or act as if they use gefc and putc; 
they can be freely intermixed. 


A file with associated buffering is called a stream and is declared to 
be a pointer to a defined type FILE. Fopen(3S) creates certain 
descriptive data for a stream and returns a pointer to designate the 
stream in all further transactions. Normally, there are three open 
streams with constant pointers declared in the <stdio.h> header file 
and associated with the standard open files: 


stdin standard input file 
stdout standard output file 
stderr standard error file 


A constant NULL (0) designates a nonexistent pointer. 


An integer-constant EOF (—1) is returned upon end-of-file or error by 
most integer functions that deal with streams (see the individual 
descriptions for details). 


An integer constant BUFSIZ specifies the size of the buffers used by 
the particular implementation. 


Any program that uses this package must include the header file of 
pertinent macro definitions, as follows: 


#include <stdio.h> 


The functions and constants mentioned in the entries of sub- 
class 3S of this manual are declared in that header file and need no 
further declaration. The constants and the following “functions” are 
implemented as macros (redeclaration of these names is perilous): 
getc, getchar, putc, putchar, ferror, feof, clearerr, and fileno. 


SEE ALSO 
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> 


open(2), close(2), Iseek(2), pipe(2), read(2), write(2), ctermid(3S), 
cuserid(3S), fclose(3S), ferror(3S), fopen(3S), fread(3S), fseek(3S), 
getc(3S), gets(3S), popen(3S), printf(3S), putc(3S), puts(3S), 
scanf(3S), setbuf(3S), system(3S), tmpfile(3S), tmpnam(3S), 
ungetc(3S). 
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DIAGNOSTICS 
Invalid stream pointers will usually cause grave disorder, possibly ~~ 
including program termination. Individual function descriptions. =, 
. ° e,¢ : 7 : Ne 
describe the possible error conditions. 
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NAME 


ftok — standard interprocess communication package 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/ipc.h> 


key_t ftok(path, id) 
char «path; 
char id; 


DESCRIPTION 


All interprocess communication facilities require the user to supply a 
key to be used by the msgget (2), semget (2), and shmget (2) sys- 
tem calls to obtain interorocess communication identifiers. One sug- 
gested method for forming a key is to use the ftok subroutine 
described below. Another way to compose keys is to include the 
project ID in the most significant byte and to use the remaining por- 
tion aS a sequence number. There are many other ways to form 
keys, but it is necessary for each system to define standards for 
forming them. If some standard is not adhered to, it will be possible 
for unrelated processes to unintentionally interfere with each other's 
operation. Therefore, it is strongly suggested that the most signifi- 
cant byte of a key in some sense refer to a project so that keys do 
not conflict across a given system. 


Ftok returns a key based on path and jd that is usable in subse- 
quent msgget , semget , and shmget system calls. Path must be 
the path name of an existing file that is accessible to the process. 
ld is a character which uniquely identifies a project. Note that ftok 
will return the same key for linked files when called with the same id 
and that it will return different keys when called with the same file 
name but different ids . 


SEE ALSO 


intro(2), msgget(2), semget(2), shmget(2). 


DIAGNOSTICS 


Ftok returns (key_t) —1 if path does not exist or if it is not accessible 
to the process. 


WARNING 
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If the file whose path is passed to ftok is removed when keys still 
refer to the file, future calls to ffok with the same path and /d will 
return an error. If the same file is recreated, then ftok is likely to 
return a different key than it did the original time it was called. 
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NAME - 
Strcat, strncat, strcmp, strncmp, strcpy, strncpy, strlen, strchr, i 
strrchr, strpbrk, strspn, strcspn, strtok — string operations Se 57 

SYNOPSIS 


#include <string.h> 


char *strcat (s1, s2) 
char *s1, *S2; 


char *strncat (s1, s2, n) 
char *s1, *s2; 
int n; 


int strcmp (s1, s2) 
char *s1, *s2; 


int strncmp (s1, s2, n) 

char *s1, *s2; 

int n; 

char *strcpy (s1, s2) 

char *s1, *s2; 

char +strncpy (s1, s2, n) 

char +*s1, *s2; 

int n; 

int strlen (s) 

char *s; 

char *strchr (s, c) 

char +s; 

int c; | 

char *strrchr (s, c) 

char *s; 

int c; 

char +strpbrk (s1, s2) 

char +s1, *s2; 

int strspn (s1, $2) 

char +*s1, *s2; 

int strespn (s1, s2) 

char +*s1, *s2; 

char *strtok (s1, s2) 

char +s1, *s2; 
DESCRIPTION —_ 

The arguments s1, s2 and s point to strings (arrays of characters. 
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( NOTE 


terminated by a null character). The functions strcat , strncat , 
Strcpy , and strncpy all alter s1 . These functions do not check for 
overflow of the array pointed to by s1. 


Strcat appends a copy of string s2 to the end of string $1. Strncat 
appends at most n characters. Each returns a pointer to the null- 
terminated result. 


Strcemp compares its arguments and returns an integer less than, 
equal to, or greater than 0, according as $1 is lexicographically less 
than, equal to, or greater than s2 . Strncmp makes the same com- 
parison but looks at at most n characters. 


Strcpy copies string s2 to $1 , stopping after the null character has 
been copied. Sfrncpy copies exactly n characters, truncating s2 or 
adding null characters to s1 if necessary. The result will not be 
null-terminated if the length of s2 is n or more. Each function 
returns st. 


Strien returns the number of characters in s , not including the ter- 
minating null character. 


Strchr (strrchr) returns a pointer to the first (last) occurrence of 
character c in string $ , or a NULL pointer if ¢ does not occur in the 
string. The null character terminating a string is considered to be 
part of the string. 


Strpbrk returns a pointer to the first occurrence in string $1 of any 
character from string s2 , or a NULL pointer if no character from s2 
exists in s1. 


Strspn (strcspn) returns the length of the initial segment of string 
$1 which consists entirely of characters from (not from) string s2 . 


Strtok considers the string s1 to consist of a sequence of zero or 
more text tokens separated by spans of one or more characters 
from the separator string s2 . The first call (with pointer s1 speci- 
fied) returns a pointer to the first character of the first token, and will 
have written a null character into s1 immediately following the 
returned token. The function keeps track of its position in the string 
between separate calls, so that subsequent calls (which must be 
made with the first argument a NULL pointer) will work through the 
string s1 immediately following that token. In this way subsequent 
calls will work through the string $1 until no tokens remain. The 
separator string s2 may be different from call to call. When no 
token remains in $1 , a NULL pointer is returned. 


For user convenience, all these functions are declared in the 
optional <string.h> header file. - 
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BUGS 
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aa 


Stremp and strncmp use native character comparison, which is “ | 
unsigned on other machines. Thus the sign of the value returned ~~ 
when one of the characters has its high-order bit set is 
implementation-dependent. 


Character movement is performed differently in different implemen- 
tations. Thus overlapping moves may yield surprises. 
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NAME 
strtod, atof — convert string to double-precision number 


SYNOPSIS 
double strtod (str, ptr) 
char «str, **ptr; 


double atof (str) 
char «str; 


DESCRIPTION 
Strtod returns as a double-precision floating-point number the value 
represented by the character string pointed to by str. The string is 
scanned up to the first unrecognized character. 


Strtod recognizes an optional string of “white-space” characters (as 
defined by isspace in ctype (3C)), then an optional sign, then a 
string of digits optionally containing a decimal point, then an optional 
e or E followed by an optional sign or space, followed by an 
integer. 


If the value of ptr is not (char **)NULL, a pointer to the character 
terminating the scan is returned in the location pointed to by pir. If 
no number can be formed, «pir is set to str, and zero is returned. 


Atof(str) is equivalent to strtod(str, (char **)NULL) . 


SEE ALSO 


ctype(3C), scanf(3S), strtol(3C). 


DIAGNOSTICS 
lf the correct value would cause overflow, +HUGE is returned 
(according to the sign of the value), and errno is set to ERANGE . 
If the correct value would cause underflow, zero is returned and 
errno is set to ERANGE . 
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NAME va 
strtol, atol, atoi — convert string to integer _ 
SYNOPSIS = 
long strtol (str, ptr, base) 
char *str, **ptr; 
int base; 
long atol (str) 
char «str; 
int atoi (str) 
char «str; 
DESCRIPTION 
Strto/ returns as a long integer the value represented by the charac- 
ter string pointed to by str. The string is scanned up to the first 
character inconsistent with the base. Leading “white-space” char- 
acters (as defined by isspace in ctype (3C)) are ignored. 
If the value of ptr is not (char **)NULL, a pointer to the character 
terminating the scan is returned in the location pointed to by ptr . If 
no integer can be formed, that location is set to str , and zero is 
returned. 


If base is positive (and not greater than 36), it is used as the base ~ 
for conversion. After an optional leading sign, leading zeros are . / 
ignored, and “Ox” or “OX” is ignored if base is 16. 


If base is zero, the string itself determines the base thusly: After an 
optional leading sign a leading zero indicates octal conversion, and 
a leading “Ox” or “OX” hexadecimal conversion. Otherwise, decimal 
conversion is used. 


Truncation from long to int can, of course, take place upon assign- 
ment or by an explicit cast. 


Atol(str) is equivalent to "strtol(str, (char **)NULL, 10)" . 
Atoi(str) is equivalent to "(int) strtol(str, (char **)NULL, 10)". 


SEE ALSO 
ctype(3C), scanf(3S), strtod(3C). 


BUGS 
Overflow conditions are ignored. 
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swab — swap bytes 


SYNOPSIS 


void swab (from, to, nbytes) 
char *from, «to; 
int nbytes; 


DESCRIPTION 
Swab copies nbytes bytes pointed to by from to the array pointed 
to by to , exchanging adjacent even and odd bytes. It is useful for 
carrying binary data between PDP-11s and other machines. Nbytes 
should be even and non-negative. If nbytes is odd and positive 
swab uses nbytes —1 instead. If nbytes is negative, swab does 
nothing. 
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NAME 
system — issue a shell command 


SYNOPSIS 
#include <stdio.h> 


int system (string) 
char «string; 


DESCRIPTION 
System causes the string to be given to sh (17) as input, as if the 
string had been typed as a command at a terminal. The current 
process waits until the shell has completed, then returns the exit 
status of the shell. 


FILES 
/bin/sh 


SEE ALSO 
exec(2). 
sh(1) in the Sys5 UNIX User Reference Manual. 
~ DIAGNOSTICS 
System forks to create a child process that in turn exec’s /bin/sh in 
order to execute string . If the fork or exec fails, system returns a 
negative value and sets errno . — 
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NAME 

tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs - terminal independent 

operation routines 
SYNOPSIS 

char PC; 

char *BC; 

char *UP; 

short ospeed; 

tgetent(bp, name) 

char *bp, *name; 

tgetnum(id) | 

char *id; 

tgetflag(id) 

char *id; 

char * 

tgetstr(id, area) 

char *id, **area; 

char * 

tgoto(cm, destcol, destline) 

char *cm; 

tputs(cp, affcnt, outc) 

register char *cp; 

int affent; 

int (*outc) (); 
DESCRIPTION 
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These functions are obsolete but were used in Sys3 and are 
included here for downward compatibility only. 


These functions extract and use capabilities from the terminal capa- 
bility data base termcap(4). These are low level routines. See 
curses(3X) for a higher level package. 


Tgetent extracts the entry for a terminal name into the buffer at bp. 
Bp should be a character buffer of size 1024 and must be retained 


‘through all subsequent calls to tgetnum, tgetflag, and tgetstr. 


Tgetent returns -1 if it cannot open the termcap file, 0 if the terminal 
name given does not have an entry, and 1 if all goes well. It looks 
in the environment for a TERMCAP variable. If found, and the value 
does not begin with a slash, and the terminal type name is the same 
as the environment string TERM, the TERMCAP string is used 
instead of reading the TERMCAP file. If it does begin with a slash, 
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the string is used as a path name rather than /etc/termcap. This 
can speed up entry into programs that call tgetent, as well as help 


you can't write the file /etc/termcap. 


Tgetnum gets the numeric value of capability id, returning -1 if id is 
not given for the terminal. Tgetflag returns 1 if the specified capabil- 
ity is present in the terminal's entry, 0 if it is not. Tgetstr gets the 
string value of the capability id, placing it in the buffer at area, and 
advancing the area pointer. It decodes the abbreviations for this 
field described in termcap(4), except for cursor addressing and pad- 
ding information. : 


Tgoto returns a cursor addressing string decoded from cm to go to 
column destcol in line destline. \It uses the external variables UP 
(from the up capability) and BC (if bc is given rather than bs) if 
necessary to avoid placing \n, “D, or “@ in the returned string. (Pro- 
grams that call tgoto should turn off the XTABS bit(s), since tgoto 
may now output a tab. Note that programs using termcap should in 
general turn off XTABS anyway, since some terminals use control | 
for other functions, such as nondestructive space.) If a % sequence 
is given that is not understood, then tgoto returns "OOPS". 


Tputs decodes the leading padding information of the string cp; 


affcnt gives the number of lines affected by the operation, or 1 if this : 
is not applicable. Outc is called with each character in turn. The ~ 


external variable ospeed should contain the output speed of the ter- 
minal as encoded by stty(2). The external variable PC should con- 
tain a pad character to be used (from the pe capability) if a null (“@) 
is inappropriate. 


FILES | 
/usr/lib/libtermlib.a termcap library 
/etc/termcap data base 
NOTES 
These routines are based on those from the University of California 
at Berkeley. 
SEE ALSO 


ex(1), curses(3X), termcap(4). 
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_ NAME 


tmpfile — create a temporary file 


~ SYNOPSIS 


#include <stdio.h> 
FILE *tmpfile () 


DESCRIPTION 
Tmpfile creates a temporary file using a name generated by 
tmpnam (3S), and returns a corresponding FILE pointer. If the file 
cannot be opened, an error message is printed using perror (3C), 
and a NULL pointer is returned. The file will automatically be deleted 
when the process using it terminates. The file is opened for update 
("wt"). 

SEE ALSO 
creat(2), unlink(2),  fopen(3S), mktemp(3C), — perror(3C), 
tmpnam(3S). 
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NAME 


tmpnam, tempnam — create a name for a temporary file 


SYNOPSIS 


#include <stdio.h> 


char *tmpnam (s) 
char «s; 


char *tempnam (dir, pfx) 
char +dir, «pfx; 


DESCRIPTION 
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These functions generate file names that can safely be used for a 
temporary file. 


Tmpnam always generates a file name using the path-prefix defined 
as P_tmpdir in the <stdio.h> header file. If s is NULL, tmpnam 
leaves its result in an internal static area and returns a pointer to 
that area. The next call to tmpnam will destroy the contents of the 
area. If s is not NULL, it is assumed to be the address of an array 
of at least L_tmpnam bytes, where L_tmpnam is a constant 
defined in <stdio.h> ; tmpnam places its result in that array and 
returns s . 


Tempnam allows the user to control the choice of a directory. The ~~ 
argument dir points to the name of the directory in which the file is — 
to be created. If dir is NULL or points to a string which is not a 


name for an appropriate directory, the path-prefix defined as 
P_tmpdir in the <stdio.h> header file is used. If that directory is 
not accessible, /tmp will be used as a last resort. This entire 
sequence can be up-staged by providing an environment variable 
TMPDIR in the user's environment, whose value is the name of the 
desired temporary-file directory. 


Many applications prefer their temporary files to have certain favor- 
ite initial letter sequences in their names. Use the pfx argument for 
this. This argument may be NULL or point to a string of up to five 
characters to be used as the first few characters of the temporary- 
file name. 


Tempnam uses malloc (3C) to get space for the constructed file 
name, and returns a pointer to this area. Thus, any pointer value 
returned from tempnam may serve as an argument to free (see 
malloc (3C)). \f tempnam cannot return the expected result for any 
reason, i.e. malloc (3C) failed, or none of the above mentioned 
attempts to find an appropriate directory was successful, a NULL 
pointer will be returned. 
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NOTES 
These functions generate a different file name each time they are 
called. 


Files created using these functions and either fopen(3S) or creat (2) 
are temporary only in the sense that they reside in a directory 
intended for temporary use, and their names are unique. It is the 
user's responsibility to use unlink (2) to remove the file when its use 
is ended. 


SEE ALSO 
creat(2), unlink(2), fopen(3S), malloc(8C), mktemp(3C), tmpfile(3S). 


BUGS 

If called more then 17,576 times in a single process, these functions 
will start recycling previously used names. 

Between the time a file name is created and the file is opened, it is 
possible for some other process to create a file with the same 
name. This can never happen if that other process is using these 
functions or mktemp, and the file names are chosen so as to render 
duplication by other means unlikely. 
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NAME 


tsearch, tfind, tdelete, twalk — manage binary search trees 


SYNOPSIS 


#include <search.h> 


char *tsearch ((char *) key, (char **) rootp, compar) 
int (*compar)( ); 

char +tfind ((char *) key, (char **) rootp, compar) 
int (*compar)( ); 

char «tdelete ((char +) key, (char **) rootp, compar) 
int (*compar)( ); 


void twalk ((char *) root, action) 
void (*action)( ); 


DESCRIPTION 
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Tsearch, tfind, tdelete, and twalk are routines for manipulating 
binary search trees. They are generalized from Knuth (6.2.2) Algo- 
rithms T and-D. All comparisons are done with a user-supplied rou- 
tine. This routine is called with two arguments, the pointers to the 
elements being compared. It returns an integer less than, equal to, 
or greater than 0, according to whether the first argument is to be 
considered less than, equal to or greater than the second argument. 
The comparison function need not compare every byte, so arbitrary 
data may be contained in the elements in addition to the values 
being compared. 


Tsearch is used to build and access the tree. Key is a pointer to a 
datum to be accessed or stored. If there is a datum in the tree 
equal to «key (the value pointed to by key), a pointer to this found 
datum is returned. Otherwise, «key is inserted, and a pointer to it 
returned. Only pointers are copied, so the calling routine must store 
the data. Rootp points to a variable that points to the root of the 
tree. A NULL value for the variable pointed to by rootp denotes an 
empty tree; in this case, the variable will be set to point to the datum 
which will be at the root of the new tree. 


Like tsearch, tfind will search for a datum in the tree, returning a 
pointer to it if found. However, if it is not found, tfind will return a 
NULL pointer. The arguments for tfind are the same as for fsearch. 


Tdelete deletes a node from a binary search tree. The arguments 
are the same as for fsearch. The variable pointed to by rootp will 
be changed if the deleted node was the root of the tree. .Tdelete 
returns a pointer to the parent of the deleted node, or a NULL 
pointer if the node is not found. 


Twalk traverses a binary search tree. Root is the root of the tree to 
be traversed. (Any node in a tree may be used as the root for a 
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walk below that node.) Action is the name of a routine to be invoked 
at each node. This routine is, in turn, called with three arguments. 
The first argument is the address of the node being visited. The 
second argument ts a value from an enumeration data type typedef 
enum { preorder, postorder, endorder, leaf | VISIT; (defined in the 
<search.h> header file), depending on whether this is the first, 
second or third time that the node has been visited (during a depth- 
first, left-to-right traversal of the tree), or whether the node is a leaf. 
The third argument is the level of the node in the tree, with the root 
being level zero. 


The pointers to the key and the root of the tree should be of type 
pointer-to-element, and cast to type pointer-to-character. Similarly, 
although declared as type pointer-to-character, the value returned 
should be cast into type pointer-to-element. 


EXAMPLE 
The following code reads in strings and stores structures containing 
a pointer to each string and a count of its length. It then walks the 
tree, printing out the stored strings and their lengths in alphabetical 
order. 


#include <search.h-> 
#include <stdio.h> 


struct node { /* pointers are stored in the tree +/ 
char «string; 
int length; 
i 
char string_space[10000]; /* space to store strings */ 
struct node nodes[500]; /* nodes to store */ 
struct node «root = NULL; /* this points to the root */ 
main( ) 
{ 


char «strptr = string_space; 
struct node «nodeptr = nodes; 
void print_node( ), twalk( ); 
int | = 0, node_compare( ); 


while (gets(strptr) '= NULL && i++ < 500) { 

/* set node */ 

nodeptr—>string = strptr; 

nodeptr—>length = strlen(strptr); 

/* put node into the tree */ 

(void) tsearch((char *)nodeptr, &root, 
node_compare); 

/* adjust pointers, don't overwrite tree «/ 
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strptr += nodeptr—>length + 1; 


nodeptr+ +; a 

twalk(root, print_node); 7 

i 

[s | 
This routine compares two nodes, based on an 
alphabetical ordering of the string field. 

*/ 

int 


node_compare(node1, node2) 
struct node «node, «node2; 


( 


return stremp(nodei — ->string, node2 — >> string); 


[x 
This routine prints out a node, the first time 
twalk encounters it. 

xf 

void 


print_node(node, order, level): 
struct node **node; 7 
VISIT order: | -_ 
int level: | Re 
{ : 
if (order == preorder {| order == leaf) { 
(void)printf("string = %20s, length = %d\n’, 
(*node)—>string, (*node) — >length); 


oe eam 


SEE ALSO | 
bsearch(3C), hsearch(3C), lsearch(3C). 


DIAGNOSTICS 
A NULL pointer is returned by tsearch if there is not enough space 
available to create a new node. 
A NULL pointer is returned by tsearch, tfind and tdelete if rootp is 
NULL on entry. 
If the datum is found, both tsearch and tfind return a pointer to it. If 
not, tfind returns NULL, and fsearch returns a pointer to the inserted 
item. 


WARNINGS 
The root argument to twa/k is one level of indirection less than my a 
rootp arguments to tsearch and tdelete. a, 
There are two nomenclatures used to refer to the order in which ees 
nodes are visited. [search uses preorder, postorder and endorder 
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to respectively refer to visting a node before any of its children, after 
its left child and before its right, and after both its children. The 
alternate nomenclature uses preorder, inorder and postorder to refer 
to the same visits, which could result in some confusion over the 
meaning of postorder. 


BUGS 


If the calling function alters the pointer to the root, results are 
unpredictable. 
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NAME 
ttyname, isatty — find name of a terminal 


SYNOPSIS 
char *ttyname (fildes) 
int fildes; 


int isatty (fildes) 
int fildes; 


DESCRIPTION 
Ttyname returns a pointer to a string containing the null-terminated 
path name of the terminal device associated with file descriptor 
fildes. 


lsatty returns 1 if fildes is associated with a terminal device, 0 oth- 
erwise. 


FILES 
/dev/*« 


DIAGNOSTICS 
Ttyname returns a NULL pointer if fides does not describe a termi- 
nal device in directory /dev. 


BUGS 


The return value points to static data whose content is overwritten ~ ~ 


by each call. 
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NAME 


ttyslot — find the slot in the utmp file of the current user 


SYNOPSIS 
int ttyslot ( ) 


DESCRIPTION | 
Ttyslot returns the index of the current user's entry in the /etc/utmp 
file. This is accomplished by actually scanning the file /etc/inittab 
for the name of the terminal associated with the standard input, the 
standard output, or the error output (0, 1 or 2). 


FILES 
/etc, inittab 
/etc, utmp 


SEE ALSO 
getut(3C), ttyname(3C). 


DIAGNOSTICS 
A value of 0 is returned if an error was encountered while searching 
for the terminal name or if none of the above file descriptors is asso- 
ciated with a terminal device. 
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NAME | 
ungetc — push character back into input stream 


SYNOPSIS oe 
#include <stdio.h> 


int ungetc (c, stream) 
int c; 
FILE «stream; 
DESCRIPTION 
Ungetc inserts the character c into the buffer associated with an 
input stream . That character, c , will be returned by the next 


getc(3S) call on that stream . Ungetc returns c , and leaves the file 
stream unchanged. 


One character of pushback is guaranteed, provided something has 
already been read from the stream and the stream is actually buf- 
fered. In the case that stream is stdin , one character may be 
pushed back onto the buffer without a previous read statement. 


If c equals EOF , ungetc does nothing to the buffer and returns EOF 


Fseek (3S) erases all memory of inserted characters. 


SEE ALSO / 
fseek(3S), getc(3S), setbuf(3S). aed 


DIAGNOSTICS 
Ungetc returns EOF if it cannot insert the character. 
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NAME 


vprintf, vfprintf, vsprintf — print formatted output of a varargs argu- 
ment list 


SYNOPSIS 


#include <stdio.h> 
#include <varargs.h> 


int vprintf (format, ap) 
char *format; 
va_list ap; 


int vfprintf (stream, format, ap) 
FILE *stream; 

char +*format; 

va_list ap; 

int vsprintf (s, format, ap) 
char +s, *format; 

va_list ap; 


DESCRIPTION 
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vprintf, vfiprintf, and vsprintf are the same as printf, forintf, and 
sprintf respectively, except that instead of being called with a vari- 
able number of arguments, they are called with an argument list as 
defined by varargs (5). 


EXAMPLE 


The following demonstrates how vfprintf could be used to write an 
error routine. 


#include <stdio.h> 
#include <varargs.h> 


[* 

* error should be called like 

* error(function_name, format, arg1, arg2...); 

x*/ 

/* VARARGSO«/ 

void 

error(va_alist) 

/* Note that the function_name and format arguments cannot be 


o separately declared because of the definition of varargs. 
*/ 
va_dcl 
{ 
va_list args; 
char *fmt; 
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va_start(args); , 
/* print out name of function causing error */ eS 
(void)fprintf(stderr, "ERROR in %s: ", va_arg(args, char *)), 
fmt = va_arg(args, char *); — 
/* print out remainder of message */ | 
(void)vfprintf(fmt, args); 
va_end(args); 
(void)abort( ); 
} 


SEE ALSO 
varargs(5). 
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NAME 


vprintf, vfprintf, vsprintf — print formatted output of a varargs argu- 
ment list 


SYNOPSIS 


#include <stdio.h> 
#include <varargs.h> 


int vprintf (format, ap) 
char «format; 
va_list ap; 


int vfprintf (stream, format, ap) 
FILE *stream; 

char *format; 

va_list ap; 


int vsprintf (s, format, ap) 
char *s, «format; 
va_list ap; 


DESCRIPTION 


vprintf , vfprintf , and vsprintf are the same as printf , fprintf , and 
sprintf respectively, except that instead of being called with a vari- 
able number of arguments, they are called with an argument list as 
defined by varargs (5). 


EXAMPLE 
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The following demonstrates how vfprintf could be used to write an 
error routine. 


#include <stdio.h> 
#include <varargs.h> 


/* 


*€ error should be called like 

* error(function_name, format, arg1, arg2...); 
* / 

i* VARARGSO+#/ 

void 


error(va_alist) 

/* Note that the function_name and format arguments cannot be 
* separately declared because of the definition of varargs. 
*/ 

va_dcl 


( 


va_list args; 
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SEE ALSO 


UNIX Sys5 VPRINTF(3X) 


char +fmt; rs 
va_start(args); a 
is print out name of function causing error */ 

(void)fprintf(stderr, "ERROR in %s: ", va_arg(args, char *)); 

fmt = va_arg(args, char *); . 

/* print out remainder of message */ 

(void)vfprintf(fmt, args); 

va_end(args): 

(void)abort( ); 


printf(3S), varargs(5). 
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NAME 
jO, j1, jn, yO, y1, yn — Bessel functions 


SYNOPSIS 
#include <math.h> 


double jO (x) 
double x; 


double j1 (x) 
double x; 


double jn (n, x) 
int n; 

double x; 
double yO (x) 
double x; 


double y1 (x) 
double x; 


double yn (n, x) 
int n; 
double x; 
( - DESCRIPTION 
po JO and j7 return Bessel functions of x of the first kind of orders 0 
and 1 respectively. Jn returns the Bessel function of x of the first 
kind of order rn. 


YO and y7 return Bessel functions of x of the second kind of orders 
O and 1 respectively. Yn returns the Bessel function of x of the 
second kind of order n. The value of x must be positive. 


DIAGNOSTICS 
Non-positive arguments cause yO , y7 and yn to return the value 
—HUGE and to set errno to EDOM. In addition, a message indicating 
DOMAIN error is printed on the standard error output. 


Arguments too large in magnitude cause jO , /1 , yO and yi7 to 
return zero and to set errno to ERANGE . In addition, a message 
indicating TLOSS error is printed on the standard error output. 


These error-handling procedures may be changed with the function 
matherr (3M). 


SEE ALSO 
matherr(3M). 
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NAME 
erf, erfc — error function and complementary error function ( i 


Mae 


SYNOPSIS ad 
#include <math.h> 


double erf (x) 
double x; 


double erfc (x) 
double x; 


DESCRIPTION 


x 


2 : 
Erf returns the error function of x , defined as ——— f e ‘dt. 
TW 9 
Erfc , which returns 1.0 — erf(x) , is provided because of the 
extreme loss of relative accuracy if erf(x) is called for large x and 


the result subtracted from 1.0 (e.g., for x = 5, 12 places are lost). 


SEE ALSO 
exp(3M). 
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NAME 


exp, log, logi0, pow, sqrt — exponential, logarithm, power, square 
root functions 


SYNOPSIS 


#include <math.h> 


double exp (x) 
double x; 


double log (x) 
double x; 


double log10 (x) 
double x; 


double pow (x, y) 
double x, y; 
double sqrt (x) 
double x; 


DESCRIPTION 


Exp returns e”. 


Log returns the natural logarithm of x . The value of x must be posi- 
tive. 


Log10 returns the logarithm base ten of x . The value of x must be 
positive. 

Pow returns x”. If x is zero, y must be positive. If x is negative, y 
must be an integer. 


Sqrt returns the non-negative square root of x . The value of x may 
not be negative. 


DIAGNOSTICS 
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Exp returns HUGE when the correct value would overflow, or 0 
when the correct value would underflow, and sets errno to ERANGE 


Log and log10 return -HUGE and set errno to EDOM when x is 
non-positive. A message indicating DOMAIN error (or SING error 
when x is 0) is printed on the standard error output. 


Pow returns 0 and sets errno to EDOM when x is 0 and y is non- 
positive, or when x is negative and y is not an integer. In these 
cases a message indicating DOMAIN error is printed on the standard 
error output. When the correct value for pow would overflow or 
underflow, pow returns +HUGE or 0 respectively, and sets errno to | 
ERANGE. 


Sqrt returns 0 and sets errno to EDOM when x is negative. A mes- 
sage indicating DOMAIN error is printed on the standard error output. 
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These error-handling procedures may be changed with the function 


matherr (3M). —_ 
SEE ALSO | ec 2 


hypot(3M), matherr(3M), sinh(3M). 
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NAME 


floor, ceil, fmod, fabs — floor, ceiling, remainder, absolute value func- 
tions 


SYNOPSIS 


#include <math.h> 


double floor (x) 
double x; 


double ceil (x) 
double x; 


double fmod (x, y) 
double x, y; 


double fabs (x) 
double x; 


DESCRIPTION 


Floor returns the largest integer (as a double-precision number) not 
greater than x. 


Ceil returns the smallest integer not less than x. 


Fmod returns the floating-point remainder of the division of x by y : 
zero if y is zero or if x/y would overflow; otherwise the number f 
with the same sign as x , such that x = /y + f for some integer /, 
and |f| < ly|. 


Fabs returns the absolute value of x, |x]. 


SEE ALSO 
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abs(3C). 
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NAME 


gamma — log gamma function 


SYNOPSIS 


#include <math.h> 


double gamma (x) 
double x; 


extern int signgam; 


DESCRIPTION 


x 


x 1 


Gamma returns In(|T'(x)|), where T(x) is defined as fe tat. 


0 
The sign of T(x) is returned in the external integer signgam . The 
argument x may not be a non-positive integer. 


The following C program fragment might be used to calculate T: 
if ((y = gamma(x)) > LN_MAXDOUBLE) 
error(); 
y = signgam * exp(y); 
where LN_MAXDOUBLE is the least value that causes exp (3M) to 
return a range error, and is defined in the <va/ues.h> header file. 


DIAGNOSTICS 


For non-negative integer arguments HUGE is returned, and errno is 
set to EDOM . A message indicating SING error is printed on the 
standard error output. 


If the correct value would overflow, gamma returns HUGE and sets 
errno to ERANGE . 


These error-handling procedures may be changed with the function 
matherr (3M). 


SEE ALSO 
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exp(3M), matherr(3M), values(5). 
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=~ NAME 


hypot — Euclidean distance function 


SYNOPSIS 


#include <math.h> 


double hypot (x, y) 
double x, y; 


DESCRIPTION 
Hypot returns 


sqrt(x * x + y * y), 


taking precautions against unwarranted overflows. 


DIAGNOSTICS 


HYPOT(3M) 


When the correct value would overflow, hypot returns HUGE and 


sets errno to ERANGE. 


These error-handling procedures may be changed with the function 


matherr (3M). 


SEE ALSO 
matherr(3M). 
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NAME | 
matherr — error-handling function 


SYNOPSIS 
#include <math.h> 


J 


int matherr (x) 
struct exception *x; 


DESCRIPTION 

Matherr is invoked by functions in the Math Library when errors are 
detected. Users may define their own procedures for handling 
errors, by including a function named matherr in their programs. 
Matherr must be of the form described above. When an error 
occurs, a pointer to the exception structure x will be passed to the 
user-supplied matherr function. This structure, which is defined in 
the <math.h> header file, is as follows: 


struct exception { 
int type; 
char «name; 
double arg1, arg2, retval; 
hi 
The element type is an integer describing the type of error that has ~ 
occurred, from the following list of constants (defined in the header _ 
file): | 


DOMAIN argument domain error 
SING argument singularity 
OVERFLOW _ overflow range error 
UNDERFLOW underflow range error 
TLOSS total loss of significance 
PLOSS partial loss of significance 


The element name points to a string containing the name of the 
function that incurred the error. The variables arg? and arg2 are 
the arguments with which the function was invoked. Refval is set to 
the default value that will be returned by the function unless the 
users matherr sets it to a different value. 


If the user's matherr function returns non-zero, no error message 
will be printed, and errno will not be set. 


lf matherr is not supplied by the user, the default error-handling pro- 
cedures, described with the math functions involved, will be invoked 
upon error. These procedures are also summarized in the table 
below. In every case, errno is set to EDOM or ERANGE and the pro- ~ 


gram continues. Lo 
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EXAMPLE 
( #include <math.h>> 
int 
matherr(x) 
register struct exception «x; 
{ 
switch (x—>type) { 
case DOMAIN: 
/* Change sart to return sqrt(—arg1), not O */ 
if (istrcmp(x—>name, “sart")) { 
x—>retval = sqrt(—x—>arg1); 
return (0); ;* print message and set errno */ 
\ 
\ 
case SING: 
/* all other domain or sing errs, print msg and abort «/ 
fprintf(stderr, “domain error in %s\n", x->name); 
abort( ); 
case PLOSS: 
/* print detailed error message */ , 
fprintf(stderr, “loss of significance in %s(%g) = %g\n", 
. x—>name, x—>arg1, x—>retval); 
( return (1); /* take no other action */ 
i } 
return (0); ;* all other errors, execute default procedure */ 
j 
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DEFAULT ERROR HANDLING PROCEDURES 


ye 
a Types of Errors | * 
| type fDomain| SING | OVERFLOW pLoss_| \—~ 
co0M | EDOM ERANGE 
ae 
ABBREVIATIONS 
As much as possible of the value is returned. 
Message is printed (EDOM error). 
HUGE is returned. 
—HUGE is returned. 
HUGE or —HUGE is returned. 
0 is returned. 
— 
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NAME 


sinh, cosh, tanh — hyperbolic functions 


SYNOPSIS 


#include <math.h> 


double sinh (x) 
double x; 


double cosh (x) 
double x; 


double tanh (x) 
double x; 


DESCRIPTION 


Sinh, cosh, and tanh return, respectively, the hyberbolic sine, 
cosine and tangent of their argument. 


DIAGNOSTICS 


Sinh and cosh return HUGE (and sinh may return -HUGE for nega- 
tive x) when the correct value would overflow and set errno to 
ERANGE. 


These error-handling procedures may be changed with the function 
matherr(3M). 


SEE ALSO 
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matherr(3M). 
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NAME 


sin, Cos, tan, asin, acos, atan, atan2 — trigonometric functions 


SYNOPSIS 


UNIX Sys5 TRIG(3M) 


#include <math.h> 


double 
double 


double 
double 


double 
double 


double 
double 


double 
double 


double 
double 


double 
double 


DESCRIPTION 


Sin, cos and tan return respectively the sine, cosine and tangent of / 
their argument, x, measured in radians. % 


sin (x) 
x; 

cos (x) 
xX; 

tan (x) 
X; 

asin (x) 
X; 

acos (x) 
X; 

atan (x) 
X; 

atan2 (y, x) 
y; X; 


prs 


Asin returns the arcsine of x, in the range —1/2 to 7/2. 


Acos returns the arccosine of x, in the range 0 to 7. 


Atan returns the arctangent of x, in the range —n/2 to 7/2. 


Atan2 returns the arctangent of y/x, in the range —m to 7, using the 
signs of both arguments to determine the quadrant of the return 


value. 
DIAGNOSTICS 


Sin, cos, and tan lose accuracy when their argument is far from 
zero. For arguments sufficiently large, these functions return zero 
when there would otherwise be a complete loss of significance. In 
this case a message indicating TLOSS error is printed on the stan- 
dard error output. For less extreme arguments causing partial loss 
of significance, a PLOSS error is generated but no message is 


printed. 


In both cases, errno is set to ERANGE. 


If the magnitude of the argument of asin or acos is greater than 
one, or if both arguments of atan2 are zero, zero is returned and 
errno is set te EDOM. In addition, a message indicating DOMAIN “ » 


error is printed on the standard error output. 
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These error-handling procedures may be changed with the function 
matherr(3M). 


= SEE ALSO 
matherr(3M). 
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NAME 
assert — verify program assertion 


SYNOPSIS 
#include <assert.h> 


assert (expression) 
int expression; 


DESCRIPTION 
This macro is useful for putting diagnostics into programs. When it 
is executed, if expression is false (zero), assert prints 


“Assertion failed: expression, file xyz, line nnn” 


on the standard error output and aborts. In the error message, xyz . 
is the name of the source file and nnn the source line number of the 
assert statement. | 


Compiling with the preprocessor option -DNDEBUG (see cpp (7)), 
or with the preprocessor control statement ‘‘#define NDEBUG’ 
ahead of the “#include <assert.h>” statement, will stop asser- 
tions from being compiled into the program. 


SEE ALSO 
abort(3C). 
cpp(1) in the Sys5 UNIX User Reference Manual. 
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NAME 


curses — CRT screen handling and optimization package 


SYNOPSIS 


#include <curses.h> 
cc [ flags |] files —Icurses [ libraries |] 


DESCRIPTION 


These routines give the user a method of updating screens with rea- 
sonable optimization. In order to initialize the routines, the routine 
initscr() must be called before any of the other routines that deal 
with windows and screens are used. The routine endwin() should 
be called before exiting. To get character-at-a-time input without 
echoing, (most interactive, screen oriented-programs want this) after 
calling initscr() you should call “‘noni(); cbreak( ); noecho( );"’ 


The full curses interface permits manipulation of data structures 
called windows which can be thought of as two dimensional arrays 
of characters representing all or part of a CRT screen. A default 
window called stdscr is supplied, and others can be created with 
newwin . Windows are referred to by variables declared “WINDOW 
*” the type WINDOW is defined in curses.h to be a C structure. 
These data structures are manipulated with functions described 
below, among which the most basic are move , and addch . (More 


general versions of these functions are included with names begin- | 
ning with ‘w’, allowing you to specify a window. The routines not > 


beginning with ‘w’ affect stdscr .) Then refresh() is called, telling 
the routines to make the users CRT screen look like stdscr . 


Mini-Curses is a subset of curses which does not allow manipulation 
of more than one window. To invoke this subset, use -DMINI- 
CURSES as a cc option. This level is smaller and faster than full 
curses. 


If the environment variable TERMINFO is defined, any program using 
curses will check for a local terminal definition before checking in 
the standard place. For example, if the standard place is 
/usr/lib/terminfo, and TERM is set to “vt100", then normally the 
compiled file is found in /usr/lib/terminfo/v/vt100. (The “v’ is 
copied from the first letter of “vt100” to avoid creation of huge direc- 
tories.) However, if TERMINFO is set to /usr/mark/myterms, curses 
will first check /opusr/mark/myterms/v/vt100, and if that fails, will 
then check /usr/lib/terminfo/v/vt100. This is useful for developing 
experimental definitions or when write permission in 
/usr/lib/terminfo is not available. 


SEE ALSO 


Page 1 


terminfo(4). 
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FUNCTIONS 
Routines listed here may be called when using the full curses. 
Those marked with an asterisk may be called when using Mini- 


Curses. 


addch(ch)* add a character to stdscr 

(like putchar) (wraps to next 

line at end of line) 
addstr(str)* calls addch with each character in str 
attroff(attrs)* turn off attributes named 
attron(attrs)* turn on attributes named 
attrset(attrs)* set current attributes to attrs 
baudrate( )* current terminal speed 
beep( )* sound beep on terminal 


box(win, vert, hor) 


clear{ ) 
clearok(win, bf) 


intrflush(win, bf) 


keypad(win, bf) 
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draw a box around edges of win 

vert and hor are chars to use for vert. 
and hor. edges of box 

clear stdscr 

clear screen before next redraw of win 


' clrtobot( ) clear to bottom of stdscr 
clirtoeol( ) clear to end of line on stdscr 
cbreak( )* set cbreak mode 
~ delay_output(ms)* insert ms millisecond pause in output 
delch( ) delete a character 
deleteln( ) delete a line 
delwin(win) delete win 
doupdate( ) update screen from all wnooutrefresh 
echo( )* set echo mode 
endwin( )* end window modes 
erase( ) erase Stdscr 
erasechar( ) return user’s erase character 
fixterm( ) restore tty to "in curses” state 
flash( ) flash screen or beep 
flushinp( )* throw away any typeahead 
getch( )* get a char from tty 
getstr(str) get a string through stdscr 
gettmode( ) establish current tty modes 
getyx(win, y, x) get (y, x) co-ordinates 
has_ic() true if terminal can do insert character 
has_il() true if terminal can do insert line 
idlok(win, bf)* use terminal's insert/delete line if bf != 0 
inch() get char at current (y, x) co-ordinates 
initscr()* initialize screens 
( of insch(c) insert a char 
7 insertin( ) insert a line 


interrupts flush output if bf is TRUE 
enable keypad input 
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killchar( ) return current user’s kill character. 
leaveok(win, flag) OK to leave cursor anywhere after refresh if ~ 
| flag!=0 for win, otherwise cursor must be left . yl 
at current position. 


longname( ) return verbose name of terminal 
meta(win, flag)* allow meta characters on input if flag != 0 
move(y, x)" move to (y, x) on stdscr 

mvaddch(y, x, ch) move(y, x) then addch(ch) 

mvadastr(y, x, str) similar... 


mvcur(oldrow, oldcol, newrow, newcol) 
low level cursor motion 


mvdelch(y, x) like delch, but move(y, x) first 
mvgetch(y, x) etc. 

mvgetstr(y, x) 

mvinch(y, x) 


mvinsch(y, xX, C) 
mvprintw({y, x, fmt, args) 
mvscanw(y, x, fmt, args) 
mvwaddch(win, y, x, ch) 
mvwaddsir{win, y, x, str) 
mvwdelch(win, y, Xx) 
mvwgetch(win, y, x) | 
mvwe¢etstr(win, y, x) : 
mvwin(win, by, bx) So 
mvwinch(win, y, x) 
mvwinsch(win, y, X, C) 
mvwprintw(win, y, x, fmt, args) 
mvwscanw(win, y, X, fmt, args) 
newpad(nlines, ncols) create a new pad with given dimensions 
newterm(type, fd) set up new term of given type to output on fd 
newwin(lines, cols, begin_y, begin_x) 

create a new window 


nl )* set newline mapping 

nocbreak( )* unset cbreak mode 

nodelay(win, bf) enable nodelay input mode through getch 
noecho({ )* unset echo mode 

noni()* unset newline mapping 

noraw( )* unset raw mode 

overlay(wint, win2) overlay win1 on win2 

overwrite(win1, win2) overwrite wint on top of win2 


pnoutrefresh(pad, pminrow, pmincol, sminrow, 
smincol, smaxrow, smaxcol) 
like prefresh but w/o output til doupdate called —_ 
prefresh(pad, pminrow, pmincol, sminrow, \ J 
smincol, smaxrow, smaxcol) a 
refresh from pad starting with given upper left 


Page 3 May 8, 1986 


CURSES(3X) _ UNIX Sys5 CURSES(3X) 


corner of pad with output to given 

portion of screen 

printw(fmt, arg, arg2, ...) : 
printf on stdscr 


raw()* set raw mode 

refresh( )* make current screen look like stdscr 
resetterm( )* set tty modes to ‘out of curses” state 
resetty()* reset tty flags to stored value 
saveterm( )* save current modes as "in curses” state 
savetty( )* store current tty flags 


scanw(fmt, arg1, arg2, ...) 
scanf through stdscr 


scroll(win) scroll win one line 

scrollok(win, flag) allow terminal to scroll if flag != 0 
set_term(new) now talk to terminal new 

setscrreg(t, b) set user scrolling region to lines t through b 
setterm(type) establish terminal with given type 
setupterm(term, filenum, errret) 

standend()* | clear standout mode attribute 

standout( )* set standout mode attribute 


subwin(win, lines, cols, begin_y, begin_x) 
create a subwindow 


touchwin(win) change all of win 

traceoff( ) turn off debugging trace output 
traceon( ) turn on debugging trace output 
typeahead(fd) use file descriptor fd to check typeahead 
unctri{ch)* printable version of ch 
waddch(win, ch) add char to win 

waddstr(win, str) add string to win 

wattroff(win, attrs) turn off attrs in win 
wattron(win, attrs) turn on attrs in win 
wattrset(win, attrs) set attrs in win to attrs 
wclear(win) clear win 

wclrtobot(win) clear to bottom of win 
wclrtoeol(win) clear to end of line on win 
wdelch(win, c) delete char from win 
wdeleteln(win) delete line from win 
werase(win) erase win 

wgetch(win) get a char through win 
woetstr(win, str) get a string through win 
winch(win) get char at current (y, x) in win 
winsch(win, c) — insert char into win 
winsertin(win) | insert line into win 

wmove(win, y, x) set current (y, x) co-ordinates on win 
wnoutrefresh(win) refresh but no screen output 


wprintw(win, fmt, arg1, arg2, ...) 
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printf on win 
wrefresh(win) make screen look like win a 
wscanw(win, fmt, arg1, arg2, ...) — | 
scanf through win 
wsetscrreg(win, t, b) set scrolling region of win 
wstandend(win) clear standout attribute in win 
wstandout(win) set standout attribute in win 


TERMINFO LEVEL ROUTINES 
These routines should be called by programs wishing to deal directly 
with the terminfo database. Due to the low level of this interface, it 
is discouraged. Initially, setupterm should be called. This will 
define the set of terminal dependent variables defined in terminfo(4). 
The include files <curses.h> and <term.h> should be included to 
get the definitions for these strings, numbers, and flags. Parmeter- 
ized strings should be passed through tparm to instantiate them. All 
terminfo strings (including the output of tparm) should be printed 
with tputs or putp . Before exiting, resetterm should be called to 
restore the tty modes. (Programs desiring shell escapes or 
suspending with control Z can call resefterm before the shell is 
called and fixterm after returning from the shell.) 
fixterm( ) restore tty modes for terminfo use 
(called by setupterm) Zr 
resetterm( ) reset tty modes to state before program entry, 
setupterm(term, fd, rc) read in database. Terminal type is the = 
character string term, all output is to UNIX 
System file descriptor fd. A status value is 
returned in the integer pointed to by rc: 1 
is normal. The simplest call would be 
: setupterm(0, 1, 0) which uses all defaults. 
tparm(str, p1, p2, ..., p9) _ 
instantiate string str with parms p,. 
tputs(str, affcnt, putc) apply padding info to string sir. 
affcnt is the number of lines affected, 
or 1 ifnot applicable. Putcisa 
putchar-like function to which the characters 
are passed, one at a time. 
putp(str) handy function that calls tputs 
(str, 1, putchar) 
vidputs(attrs, putc) output the string to put terminal in video 
attribute mode attrs, which is any 
combination of the attributes listed below. 
Chars are passed to putchar-like 
function putc. ( 
vidattr(attrs) Like vidputs but outputs through ee 
putchar 
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TERMCAP COMPATIBILITY ROUTINES 
These routines were included as a conversion aid for programs that 
use termcap. Their parameters are the same as for termcap. They 
are emulated using the terminfo database. They may go away at a 


later date. 
tgetent(bp, name) 
tgetflag(id) 
tgetnum(id) 
tgetstr(id, area) 
tgoto(cap, col, row) 
touts(cap, affcnt, fn) 


ATTRIBUTES 


look up termcap entry for name 


get boolean entry for id 
get numeric entry for id 
get string entry for id 
apply parms to given cap 


apply padding to cap calling fn as. 


The following video attributes can be passed to the functions attron , 


attroff , attrset . 
A_STANDOUT 
A_UNDERLINE 
A_REVERSE 
A_BLINK 

A_DIM 

A_BOLD 
A_BLANK 
A_PROTECT 
A_ALTCHARSET 


FUNCTION KEYS 


Terminal’s best highlighting mode 
Underlining 

Reverse video 

Blinking 

Half bright 

Extra bright or bold 

Blanking (invisible) 

Protected 

Alternate character set 


The following function keys might be returned by getch if keypad 
has been enabled. Note that not all of these are currently sup- 
ported, due to lack of definitions in terminfo or the terminal not 
transmitting a unique code when the key is pressed. 


Name 

KEY BREAK 
KEY DOWN 
KEY UP 
KEY_LEFT 
KEY RIGHT 
KEY HOME 
KEY _BACKSPACE 
KEY_FO 
KEY_F(n) 
KEY_DL 
KEY_IL 

KEY _DC 
KEY_IC 
KEY_EIC 
KEY_CLEAR 
KEY_EOS 
KEY EOL 
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Value Key name 

0401 break key (unreliable) 

0402 The four arrow keys ... 

0403 

0404 

0405 

0406 Home key (upward + left arrow) 
0407 backspace (unreliable) 

0410 Function keys. Space reserved for 64. 
(KEY_FO+(n)) Formula for fn. 

0510 Delete line 

0511 Insert line 

0512 Delete character 

0513 Insert char or enter insert mode 
0514 Exit insert char mode 

0515 Clear screen 

0516 | Clear to end of screen 

0517 Clear to end of line 
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KEY_SR 0521 Scroll 1 line backwards (reverse) fos 

KEY_NPAGE 0522 Next page : a, 

KEY_PPAGE 0523 Previous page 7 

KEY_STAB 0524 Set tab 

KEY_CTAB 0525 Clear tab 

KEY_CATAB 0526 Clear all tabs 

KEY_ENTER 0527 Enter or send (unreliable) 

KEY_SRESET 0530 soft (partial) reset (unreliable) 

KEY_RESET 0531 reset or hard reset (unreliable) 

KEY_PRINT 0532 print or copy 

KEY_LL 0533 home down or bottom (lower left) 
WARNING , 

The plotting library plot (3X) and the curses library curses (3X) both 

use the names erase() and move(). The curses versions are mac- 

ros. If you need both libraries, put the p/ot (3X) code in a different 

source file than the curses (3X) code, and/or #undef move() and 

erase() in the plot (3X) code. 

— 


Page 7 


KEY SF 0520 Scroll 1 line forward 


May 8, 1986 


( 


LDAHREAD(3X) UNIX Sys5 LDAHREAD(3X) 


NAME 


Idahread — read the archive header of a member of an archive file 


SYNOPSIS 


#include <stdio.h> 
#include <ar.h> 
#include <filehdr.h> 
#include <Idfcn.h> 


int Ildahread (Idptr, arhead) 
LDFILE «ldptr; 
ARCHDR «arhead; 


DESCRIPTION 


lf TYPE(/dptr) is the archive file magic number, /dahread reads the 
archive header of the common object file currently associated with 
ldptr into the area of memory beginning at arhead . 


Ldahread returns SUCCESS or FAI Ldahread will fail if TYPE(/dptr) 
does not represent an archive file, or if it cannot read the archive 
header. 


The program must be loaded with the object file access routine 
library libld.a . 


SEE ALSO 
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Idclose(3X), Idopen(3X), Idfcn(4), ar(4). 
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NAME 


Idclose, Idaclose — close a common object file 


SYNOPSIS 


#include <stdio.h> 
#include <filehdr.h> 
#include <Idfcn.h> 


int Idclose (Idptr) 
LDFILE «ldptr; 


int Idaclose (Idptr) 
LDFILE *Idptr; 


DESCRIPTION 


Ldopen (3X) and Idclose are designed to provide uniform access to 
both simple object files and object files that are members of archive 
files. Thus an archive of common object files can be processed as 
if it were a.series of simple common object files. 


If TYPE(/dptr) does not represent an archive file, /dclose will close 
the file and free the memory allocated to the LDFILE structure 
associated with /dptr . If TYPE(/dptr) is the magic number of an 


archive file, and if there are any more files in the archive, /dclose ~~ 


will reinitialize OFFSET(/dptr) to the file address of the next archive . 


member and return FAILURE . The LDFILE structure is prepared for 
a subsequent /dopen (3X). In all other cases, /dclose returns SUC- 
CESS. 


Ldacilose closes the file and frees the memory allocated to the 
LDFILE structure associated with /dptr regardless of the value of 
TYPE(/dptr). Lodaclose always returns SUCCESS. The function is 
often used in conjunction with /daopen . 


The program must be loaded with the object file access routine 
library libld.a . 


SEE ALSO 
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fclose(3S), ldopen(3X), Idfcn(4). 
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- NAME 


ldfhread — read the file header of a common object file 


SYNOPSIS 


#include <stdio.h> 
#include <filehdr.h> 
#include <Idfcn.h> 


int Idfhread (Idptr, filehead) 
LDFILE *ldptr; 
FILHDR +filehead; 


DESCRIPTION 


Ldfhread reads the file header of the common object file currently 
associated with /dpitr into the area of memory beginning at filehead . 


Ldfhread returns SUCCESS or FAI Ldfhread will fail if it cannot read 
the file header. 


In most cases the use of /dfhread can be avoided by using the 
macro HEADER(/dpir) defined in Idfcn.h (see Idfcn (4)). The infor- 
mation in any field, fieldname , of the file header may be accessed 
using HEADER ({ Idptr ). fieldname. 


The program must be loaded with the object file access routine 
library libld.a . 


SEE ALSO 
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Idclose(3X), Idopen(3X), Idfcn(4). 
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NAME 


Idgetname — retrieve symbol name for common object file symbol 
table entry 


SYNOPSIS 


#include <stdio.h> 
#include <filehdr.h> 
#include <syms.h> 
#include <Idfcn.h> 


char *ldgetname (Idptr, symbol) 
LDFILE «Idptr; 
SYMENT *symbol; 


DESCRIPTION 


Ldgetname returns a pointer to the name associated with symbol 
as a string. The string is contained in a static buffer local to /dget- 
name that is overwritten by each call to [dgetname , and therefore 
must be copied by the caller if the name is to be saved. 


As of UNIX system release 5.0, the common object file format has 
been extended to handle arbitrary length symbol names with the 
addition of a “string table”. Ldgetname will return the symbol name 
associated with a symbol table entry for either a pre-UNIX system 
5.0 object file or a UNIX system 5.0 object file. Thus, /dgetname 
can be used to retrieve names from object files without any back- 
ward compatibility problems. Ldgetname will return NULL (defined 
in stdio.h ) for a UNIX system 5.0 object file if the name cannot be 
retrieved. This situation can occur: 


— if the “string table” cannot be found, 
~ if not enough memory can be allocated for the string table, 


_ if the string table appears not to be a string table (for exam- 
ple, if an auxiliary entry is handed to /dgetname that looks 
like a reference to a name in a non-existent string table), or 


_ if the name's offset into the string table is past the end of 
the string table. 


Typically, /dgetname will be called immediately after a successful 
call to /dtbread to retrieve the name associated with the symbol 
table entry filled by /dfbread . 


The program must be loaded with the object file access routine 
library libld.a . | 


SEE ALSO 
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Idclose(3X), ldopen(3X), Idtbread(3X), Idtbseek(3X), Idfcn(4). 
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NAME 
Idiread, Idlinit, Idlitem — manipulate line number entries of a common 
object file function 
SYNOPSIS 
#include <stdio.h> 
#include <filehdr.h> 
#include <linenum.h> 
#include <Idfcn.h> 
int Idlread(Idptr, fcenindx, linenum, linent) 
LDFILE «ldptr; 
long fenindx; 
unsigned short linenum; 
LINENO linent; 
int Idlinit(Idptr, fenindx) 
LDFILE «ldptr; 
long fcnindx; 
int Idlitem(Idptr, linenum, linent) 
LDFILE *Idptr; 
unsigned short linenum; 
LINENO linent; 
DESCRIPTION 
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Ldiread searches the line number entries of the common object file 
currently associated with /dptr . Ldlread begins its search with the 
line number entry for the beginning of a function and confines its 
search to the line numbers associated with a single function. The 
function is identified by fenindx , the index of its entry in the object 
file symbol table. Ldfread reads the entry with the smallest line 
number equal to or greater than /inenum into linent . 


Ldlinit and /dlitem together perform exactly the same function as 
ldiread. After an initial call to /d/read or Idlinit, ldlitem may be used 
to retrieve a series of line number entries associated with a single 
function. Ldfinit simply locates the line number entries for the func- 
tion identified by fcnindx. Ldlitem finds and reads the entry with the 
smallest line number equal to or greater than linenum into linent . 


Ldiread , Idlinit , and /dlitem each return either SUCCESS or 
FAILURE . Ld/read will fail if there are no line number entries in the 
object file, if fenindx does not index a function entry in the symbol 
table, or if it finds no line number equal to or greater than linenum . 
Lodlinit will fail if there are no line number entries in the object file or 
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if fcnindx does not index a function entry in the symbol table. Ldli- 


tem will fail if it finds no line number equal to or greater than line- 4 % 
num. Sy 
The programs must be loaded with the object file access routine 
library libld.a . 

SEE ALSO 
Idclose(3X), Idopen(3X), Idtbindex(3X), Idfcn(4). 
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NAME 


C 


Idlseek, Idniseek — seek to line number entries of a section of a 
common object file 


SYNOPSIS 


#include <stdio.h> 
#include <filehdr.h> 
#include <Idfcn.h> 


int Idlseek (Idptr, sectindx) 
LDFILE «Idptr; 
unsigned short sectindx; 


int Idniseek (Idptr, sectname) 
LDFILE *ldptr; 
char *sectname; 


DESCRIPTION 


Ldiseek seeks to the line number entries of the section specified by 
sectindx of the common object file currently associated with /dptr . 


Ldniseek seeks to the line number entries of the section specified 
by sectname . 


Ladlseek and /dniseek return SUCCESS or FAILURE . La/seek will fail 
if sectindx is greater than the number of sections in the object file: 
ldniseek will fail if there is no section name corresponding with 
*sectname. Either function will fail if the specified section has no 
line number entries or if it cannot seek to the specified line number 
entries. 


Note that the first section has an index of one . 


The program must be loaded with the object file access routine 
library libld.a . 


SEE ALSO 
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Idclose(3X), Idopen(3X), Idshread(3X), Idfcn(4). 
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NAME | pis 
Idohseek — seek to the optional file header of a common object file \ } 


SYNOPSIS 
#include <stdio.h> 
#include <filehdr.h> 
#include <Idfcn.h> 


int Idohseek (Idptr) 
LDFILE «Idptr; 


DESCRIPTION 
Ldohseek seeks to the optional file header of the common oven file 
currently associated with /dptr . 


Ldohseek returns SUCCESS or FAI Ldohseek will fail if the object file 
has no optional header or if it cannot seek to the optional header. 


The program must be loaded with the object file access routine 
library libld.a . 


SEE ALSO 
Idclose(3X), Idopen(3X), Idfhread(3X), Idfcn(4). 
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NAME 
( " Idopen, Idaopen — open a common object file for reading 


SYNOPSIS 
#include <stdio.h> 
#include <filehdr.h> 
#include <Idfcn.h> 


LDFILE *ldopen (filename, Idptr) 
char +filename; 
LDFILE *ldptr; 


LDFILE *Ildaopen (filename, oldptr) 
char +filename; 
LDFILE *oldptr; 


DESCRIPTION 
Ldopen and Idclose (3X) are designed to provide uniform access to 
both simple object files and object files that are members of archive 
files. Thus an archive of common object files can be processed as 
if it were a series of simple common object files. 


lf /dptr has the value NULL, then /dopen will open filename and allo- 
Cate and initialize the LDFILE structure, and return a pointer to the 
structure to the calling program. 


( | If (dptr is valid and if TYPE(/dptr) is the archive magic number, /do- 
| pen will reinitialize the LDFILE structure for the next archive 
member of filename. 


Ldopen and Idclose (3X) are designed to work in concert. Ldclose 
will return FAILURE only when TYPE(/dptr) is the archive magic 
number and there is another file in the archive to be processed. 
Only then should /dopen be called with the current value of /dptr. In 
all other cases, in particular whenever a new filename is opened, 
Idopen should be called with a NULL /dptr argument. 


The following is a prototype for the use of /dopen and /dclose (3X). 
/* for each filename to be processed */ 


Idptr = NULL; 
do 
if ( (Idptr = Idopen(filename, Idptr)) != NULL ) 
{ 
/* check magic number */ 
/* process the file */ 
( 7 } while (Idclose(Idptr) == FAILURE ); 


lf the value of o/dptr is not NULL, /daopen will open filename anew 
and allocate and initialize a new LDFILE structure, copying the TYPE, 
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OFFSET, and HEADER fields from o/dptr. Ldaopen returns a pointer 
to the new LDFILE structure. This new pointer is independent of ~ > 
the old pointer, o/dptr . The two pointers may be used concurrently \_ 
to read separate parts of the object file. For example, one pointer 
may be used to step sequentially through the relocation information, 
while the other is used to read indexed symbol table entries. 


Both /dopen and /daopen open filename for reading. Both functions 
return NULL if filename cannot be opened, or if memory for the 
LDFILE structure cannot be allocated. A successful open does not 
insure that the given file is a common object file or an archived 
object file. 


The program must be loaded with the object file access routine 
library libld.a . 


SEE ALSO | 
fopen(3S), Idclose(3X), Idfcn(4). 
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NAME 


ldrseek, Idnrseek — seek to relocation entries of a section of a com- 
mon object file 


SYNOPSIS 


#include <stdio.h> 
#include <filehdr.h> 
#include <Idfcn.h> 


int Idrseek (Idptr, sectindx) 
LDFILE *Idptr; 
unsigned short sectindx; 


int Idnrseek (Idptr, sectname) 
LDFILE «Idptr; 
char *sectname; 


DESCRIPTION 


Ldrseek seeks to the relocation entries of the section specified by 
sectindx of the common object file currently associated with /dptr . 


Ldnrseek seeks to the relocation entries of the section specified by 
secitname . 


Ldrseek and /dnrseek return SUCCESS or FAIL Lorseek will fail if 
sectindx is greater than the number of sections in the object file; 
ldnrseek will fail if there is no section name corresponding with 
sectname . Either function will fail if the specified section has no 
relocation entries or if it cannot seek to the specified relocation 
entries. 


Note that the first section has an index of one . 


The program must be loaded with the object file access routine 
library libld.a . 


SEE ALSO 
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Idclose(3X), Idopen(3X), Idshread(3X), Idfcn(4). 
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NAME | 
Idshread, Idnshread — read an indexed/named section header of a ( 
common object file ew 

SYNOPSIS 


#include <stdio.h> 
#include <filehdr.h> 
#include <scnhdr.h> 
#include <Idfcn.h> 


int ldshread (Iidptr, sectindx, secthead) 
LDFILE *lIdptr; 

unsigned short sectindx; 

SCNHDR ~«secthead; 


int Idnshread (idptr, sectname, secthead) 
LDFILE *ldptr; 

char *sectname; 

SCNHDR +*secthead; 


DESCRIPTION 
Ldshread reads the section header specified by sectindx of the 
common object file currently associated with /dptr into the area of 
memory beginning at secthead . 


Ldnshread reads the section header specified by sectname into the _ J 
area of memory beginning at secthead . ie 


Ldshread and Idnshread return SUCCESS or FAILURE . Ldshread 

will fail if sectindx is greater than the number of sections in the 

object file; [dnshread will fail if there is no section name correspond- 

ing with sectname . Either function will fail if it cannot read the 
. specified section header. 


Note that the first section header has an index of one . 


The program must be loaded with the object file access routine 
library libld.a . 


SEE ALSO 
Idclose(3X), ldopen(3X), Idfcn(4). 
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NAME 


ldsseek, Idnsseek — seek to an indexed/named section of a common 
object file 


SYNOPSIS 
#include <stdio.h> 
#include <filehdr.h> 
#include <Idfcn.h> 


int Idsseek (Idptr, sectindx) 
LDFILE «Ildptr; 
unsigned short sectindx; 


int Idnsseek (Idptr, sectname) 
LDFILE *ldptr; 
char *sectname; 


DESCRIPTION 
Ldsseek seeks to the section specified by sectindx of the common 
object file currently associated with /dptr . 


Ldnsseek seeks to the section specified by sectname . 


Ldsseek and /[dnsseek return SUCCESS or FAIL Ldsseek will fail if 
sectindx is greater than the number of sections in the object file; 
Idnsseek will fail if there is no section name corresponding with 
sectname . Either function will fail if there is no section data for the 
specified section or if it cannot seek to the specified section. 


Note that the first section has an index of one . 


The program must be loaded with the object file access routine 
library libld.a . 


SEE ALSO 
Idclose(3X), Idopen(3X), Idshread(3X), Idfen(4). 


Page 1 May 21, 1985 


LDTBINDEX(3X) UNIX Sys5 LDTBINDEX(3X). 


NAME ee - 
Idtbindex — compute the index of a symbol table entry of a common —_ 
object file ae, 

SYNOPSIS 


#include <stdio.h> 
#include <filehdr.h> 
#include <syms.h> 
#include <idfcn.h> 


long Idtbindex (idptr) 
LDFILE *Idptr; 


DESCRIPTION ee , 
Ldtbindex returns the (long) index of the symbol table entry at the 
current position of the common object file associated with /dptr . 


The index returned by /dtbindex may be used in subsequent calls to 
idtbread (3X). However, since /dtbindex returns the index of the 
symbol table entry that begins at the current position of the object 
file, if dtbindex is called immediately after a particular symbol table 
entry has been read, it will return the index of the next entry. 


Ldtbindex will fail if there are no symbols in the object file, or if the 
object file is not positioned at the beginning of a symbol table entry. - 


Note that the first symbol in the symbol table has an index of zero. = 
The program must be loaded with the object file access routine 
library libld.a . | 

SEE ALSO 


Idclose(3X), ldopen(3X), Idtbread(3X), Idtbseek(3X), Idfcn(4). 
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= NAME 
Idtoread — read an indexed symbol table entry of a common object 
é file 
SYNOPSIS 
#include <stdio.h> 
#include <filehdr.h> 
#include <syms.h> 
#include <Idfcn.h> 
int Idtbread (Idptr, symindex, symbol) 
LDFILE *Idptr; 
long symindex; 
SYMENT *symbol; 
DESCRIPTION 
Latbread reads the symbol table entry specified by symindex of the 
common object file currently associated with Idptr into the area of 
memory beginning at symbol . 
Latbread returns SUCCESS or FAILURE . Latbread will fail if sym- 
index is greater than the number of symbols in the object file, or if it 
cannot read the specified symbol table entry. 
- Note that the first symbol in the symbol table has an index of zero . 
( The program must be loaded with the object file access routine 
library libld.a . 
SEE ALSO 
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Idclose(3X), Idopen(3X), Idtbseek(3X), Idgetname(3X), Idfcn(4). 
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NAME 


Idtbseek — seek to the symbol table of a common object file 


SYNOPSIS 


#include <stdio.h> 
#include <filehdr.h> 
#include <Idfcn.h> 


int Idtbseek (Idptr) 
LDFILE +*ldptr; 


DESCRIPTION 


Ldtbseek seeks to the symbol table of the object file currently asso- 
ciated with /dptr . 


Ldtbseek returns SUCCESS or FAI Lotbseek will fail if the symbol 
table has been stripped from the object file, or if it cannot seek to 
the symbol table. 


The program must be loaded with the object file access routine 
library libld.a . 


SEE ALSO 
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Idclose(3X), Idopen(3X), Idtbread(3X), Idfcn(4). 


May 21, 1985 


es 


LOGNAME (3X) UNIX Sys5 LOGNAME(3X) 


NAME 
logname — return login name of user 


SYNOPSIS 
char +logname( ) 


DESCRIPTION | 
Logname returns a pointer to the null-terminated login name; it 
extracts the $LOGNAME variable from the user’s environment. 


This routine is kept in /lib/libPW.a . 


FILES 
/etc/profile 


SEE ALSO 

profile(4), environ(5). 

env(1), login(1) in the Sys5 UNIX User Reference Manual. 
BUGS 
The return values point to static data whose content is overwritten 
by each call. 


This method of determining a login name is subject to forgery. 
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NAME 
malloc, free, realloc, calloc, mallopt, mallinfo — fast main memory 
allocator 
SYNOPSIS 
#include <malloc.h> 
char *malloc (size) 
unsigned size; 
void free (ptr) 
char =ptr; 
char +realloc (ptr, size) 
char +ptr; 
unsigned size; 
char *calloc (nelem, elsize) 
unsigned nelem, elsize; 
int mallopt (cmd, value) 
int cmd, value; 
struct mallinfo mallinfo (max) 
int max; 
DESCRIPTION | 
Malloc and free provide a simple general-purpose memory alloca- 
tion package, which runs considerably faster than the malloc (3C) 
package. It is found in the library ‘malloc’, and is loaded if the 
option “—Imalloc” is used with cc (1) or /d (7). 
Malloc returns a pointer to a block of at least size bytes suitably 
aligned for any use. 
The argument to free is a pointer to a block previously allocated by 
malloc ; after free is performed this space is made available for 
further allocation, and its contents have been destroyed (but see 
mallopt below for a way to change this behavior). 
Undefined results will occur if the space assigned by malloc is over- 
run or if some random number is handed to free . 
Realloc changes the size of the block pointed to by ptr to size 
bytes and returns a pointer to the (possibly moved) block. The con- 
tents will be unchanged up to the lesser of the new and old sizes. 
Calloc allocates space for an array of nelem elements of size elsize 
. The space is initialized to zeros... 
Mallopt provides for control over the allocation algorithm. The avail- 
able values for cmd are: 
M_MXFAST Set maxfast to value. The algorithm allocates all 
blocks below the size of maxfast in large groups and 
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then doles them out very quickly. The default value 
for maxfast is 0. 


Set numibiks to value . The above mentioned “large 
groups” each contain numilbiks blocks. Numilbliks 
must be greater than 0. The default value for 
numliblks ts 100. 


Set grain to value . The sizes of all blocks smaller 
than maxfast are considered to be rounded up to the 
nearest multiple of grain . Grain must be greater than 
0. The default value of grain is the smallest number 
of bytes which will allow alignment of any data type. 
Value will be rounded up to a multiple of the default 
when grain is set. 


Preserve data in a freed block until the next malloc , 
realloc , or calloc . This option is provided only for 
compatibility with the old version of malloc and is not 
recommended. 


These values are defined in the <malloc.h> header file. 


Mallopt may be called repeatedly, but may not be called after the 
first small block is allocated. 


Mallinfo provides instrumentation describing space usage. It returns 


the structure: 


struct mallinfo { 


int arena; /* total space in arena */ 
int ordbiks; /* number of ordinary blocks */ 
int smblks; /* number of small blocks */ 
int hblkhd; /* space in holding block headers */ 
int hbiks; /* number of holding blocks */ 
int usmblks; /* space in small blocks in use */ 
int fsmbiks; /“ space in free small blocks */ 
int uordblks; /" space in ordinary blocks in use */ 
int fordbiks; /" space in free ordinary blocks */ 
Int keepcost; /* space penalty if keep option */ 

/* is used */ 


j 


This structure is defined in the <malloc.h> header file. 


Each of the allocation routines returns a pointer to space suitably 
aligned (after possible pointer coercion) for storage of any type of 


object. 
SEE ALSO 


brk(2), malloc(3C). 
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DIAGNOSTICS 
Malloc, realfoc and calfoc return a NULL pointer if there is not 
enough available memory. When reaifoc returns NULL, the block. 
pointed to by pir is left intact. If mallopt is called after any alloca- — 
tion or if cmd or value are invalid, non-zero is returned. Otherwise, 
it returns zero. 


WARNINGS 
This package usually uses more data space than malloc (3C). 
The code size is also bigger than malloc (3C). 
Note that unlike malloc (3C), this package does not preserve the 
contents of a block when it is freed, unless the M_KEEP option of 
mallopt is used. 
Undocumented features of malloc (3C) have not been duplicated. 


‘a 
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NAME 


. ( SYNOPSIS 


plot — graphics interface subroutines 


openpl () 
erase () 


label (s) 
char +s; 


line (x1, y1, x2, y2) 
int x1, y1, x2, y2; 


circle (x, y, r) 
int x, y, °; 


arc (x, y, x0, yO, x1, y1) 
int x, y, x0, yO, x1, y1; 


move (x, y) 
int x, y; 
cont (x, y). 
int x, y; 
point (x, y) 
int x, y; 


linemod (s) 
char +s; 


space (x0, yO, x1, y1) 
int x0, yO, x1, y1; 


closepl () 


DESCRIPTION 
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These subroutines generate graphic output in a relatively device- 
independent manner. Space must be used before any of these 
functions to declare the amount of space necessary. See plot(4). 
Openp/ must be used before any of the others to open the device 
for writing. Closep/ flushes the output. 


Circle draws a circle of radius r with center at the point (x, y). 


Arc draws an arc of a circle with center at the point (x, y) between 
the points (x0, yO) and (x7, y7). 


String arguments to fabel and linemod are terminated by nulls and 
do not contain new-lines. 


See plot(4) for a description of the effect of the remaining functions. 


The library files listed below provide several flavors of these rou- 
tines. 


July 15, 1986 


PLOT(3X) UNIX Sys5 PLOT (3X) 


FILES Fe 
/usr/lib/libplot.a produces output for tp/ot(1G) filters a 
/usr/ib/lib300.a for DAS! 300 a 
/usr/lib/lib300s.afor DAS! 300s i 
/usr/lib/lib450.a for DAS! 450 
/usr/lib/ib4014.a for TEKTRONIX 4014 

WARNINGS 
In order to compile a program containing these functions in file.c it 
is necessary to use “cc file.c —Iplot’’. 

In order to execute it, it is necessary to use “a.out|tplot”. 

The above routines use <stdio.h>, which causes them to 
increase the size of programs, not otherwise using standard 1|/O, 
more than might be expected. 

SEE ALSO 
plot(4). 
graph(1G), stat(1G), tplot(1G) in the Sys5 UN/x User Reference 
Manual. 

x 
-_ 
jo 
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NAME 


regcmp, regex — compile and execute regular expression 


SYNOPSIS 


char *regcmp (string1 [, string2, ...], (char *)0) 
char *string1, *string2, ...; 


char +regex (re, subject[, ret0, ...]) 
char +re, *subject, *ret0, ...; 


extern char *_ loc1; 


DESCRIPTION 
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Regcmp compiles a regular expression and returns a pointer to the 
compiled form. Ma/ioc(3C) is used to create space for the vector. 
It is the user’s responsibility to free unneeded space so allocated. A 
NULL return from regcmp indicates an incorrect argument. 
Regcmp(1) has been written to generally preclude the need for this 
routine at execution time. 


Regex executes a compiled pattern against the subject string. 
Additional arguments are passed to receive values back. Regex 
returns NULL on failure or a pointer to the next unmatched character 
on success. A global character pointer _ foc? points to where the 
match began. Regcmp and regex were mostly borrowed from the 
editor, ed(1); however, the syntax and semantics have been 
changed slightly. The following are the valid symbols and their 
associated meanings. 


[]*. These symbols retain their current meaning. 
$ Matches the end of the string; \n matches a new-line. 


_ Within brackets the minus means through. For example, 
[a—z] is equivalent to [abcd...xyz]. The — can appear 
as itself only if used as the first or last character. For 
example, the character class expression []—] matches the 
characters ] and -. 


+ A regular expression followed by + means one or more 
times. For example, [0—-9]+ is equivalent to [0—9][0—9]=. 
{m} {m,} {m,u} 


Integer values enclosed in {} indicate the number of times 
the preceding regular expression is to be applied. The 
value m is the minimum number and u is a number, less 
than 256, which is the maximum. If only m is present 
(e.g., {m}), it indicates the exact number of times the regu- 
lar expression is to be applied. The value {m,} is analo- 
gous to {m, infinity}. The plus (+) and star (*) operations 
are equivalent to {1,} and {0,} respectively. 
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(...)$n The value of the enclosed regular expression is to be 
returned. The value will be stored in the (n+7)th argu-~ ~» 
ment following the subject argument. At most ten\ / 
enclosed regular expressions are allowed. Regex makes 
its assignments unconditionally. 


(...) | Parentheses are used for grouping. An operator, e.g., *, 
+, {}, can work on a single character or a regular expres- 
sion enclosed in parentheses. For example, 
(ax(cb+ )*)$0. : 


By necessity, all the above defined symbols are special. They 
must, therefore, be escaped to be used as themselves. 


EXAMPLES 
Example 1: 
char «cursor, *newcursor, «ptr; 


newcursor = regex((ptr = regcmp('\n"", 0)), cursor); 
free(ptr); 


This example will match a leading new-line in the subject string 
pointed at by cursor. 


Example 2: 
char retO[9]; | 
char *newcursor, «name; ane 


name = regcmp("([A—Za—z][A—za—z0—9_]{0,7})$0", 0); 

newcursor = regex(name, "123Testing321", retO); 
This example will match through the string “Testing3” and will return 
the address of the character after the last matched character (cur- 
sort+11). The string “Testing3” will be copied to the character array 
retd. 
Example 3: 

#include "file.i" 

char «string, *newcursor; 


newcursor = regex(name, string); 
This example applies a precompiled regular expression in file.i (see 
regcmp(1)) against string. 
This routine is kept in /lib/libPW.a. 


SEE ALSO 
malloc(3C). ao™ 
ed(1), regemp(1) in the Sys5 UNIX User Reference Manual. | | 


BUGS 
The user program may run out of memory if regcomp is called 
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iteratively without freeing the vectors no longer required. The follow- 
ing user-supplied replacement for malioc(3C) reuses the same vec- 
tor saving time and space: 


/* user's program */ 


char * 
malloc(n) 
unsigned n; 
{ 
static char rebuf[512]; 
return (nN <= sizeof rebuf) ? rebuf : NULL; 
} 
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NAME 3 
sputl, sgetl — access long integer data in a machine- independent fo _ 
fashion. | J 
SYNOPSIS 
void sputl (value, buffer) 
long value; 


char +buffer; 


long sgetl (buffer) 
char +*buffer; 


DESCRIPTION 
Sputl takes the four bytes of the long integer value and places them 
in memory starting at the address pointed to by buffer. The order- 
ing of the bytes is the same across all machines. 


Sget/ retrieves the four bytes in memory starting at the address 
pointed to by buffer and returns the long integer value in the byte 
ordering of the host machine. 


The combination of sput! and sgetl provides a machine-independent 
way of storing long numeric data in a file in binary form without 
conversion to characters. 


A program which uses these functions must be loaded with the a 
object-file access routine library libld.a. 
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NAME 
abort — terminate Fortran program 

SYNOPSIS 
call abort ( ) 

DESCRIPTION | | : 
Abort terminates the program which calls it, closing all open files 
truncated to the current position of the file pointer. 

DIAGNOSTICS 
When invoked, abort prints “Fortran abort routine called” on the 
standard error output. | 


SEE ALSO 
abort(3C). 
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NAME 


abs, labs, dabs, cabs, zabs — Fortran absolute value 


SYNOPSIS 


integer i1, i2 

real r1, r2 

double precision dp1, dp2 
complex cx1, cx2 

double complex dx1, dx2 


r2 = abs(r1) 
i2 = tabs(i1) 
i2 = abs(it) 


dp2 = dabs(dp1) 
dp2 = abs(dp1) 
cx2 = cabs(cx1) 
cx2 = abs(cx1) 
dx2 = zabs(dx1) 
dx2 = abs(dx1) 


DESCRIPTION 


Abs is the family of absolute value functions. /abs returns the 


integer absolute value of its integer argument. Dabs returns the — 


double-precision absolute value of its double-precision argument. 
Cabs returns the complex absolute value of its complex argument. 
Zabs returns the double-complex absolute value of its double- 
complex argument. The generic form abs returns the type of its 
argument. 


SEE ALSO 
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floor(3M). 
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NAME 

acos, dacos — Fortran arccosine intrinsic function 
SYNOPSIS 

real r1, r2 


double precision dp1, dp2 
r2 = acos(r1) 
dp2 = dacos(dp1) 
dp2 = acos(dp1) 
DESCRIPTION 
Acos returns the real arccosine of its real argument. Dacos returns 
the double-precision arccosine of its double-precision argument. 


The generic form acos may be used with impunity as its argument 
will determine the type of the returned value. 


SEE ALSO 
trig(3M). 
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NAME 
aimag, dimag — Fortran imaginary part of complex argument 


SYNOPSIS 
real r 
complex cxr 
double precision dp 
double complex cxd 


r = aimag(cxr) 
dp = dimag(cxd) 


DESCRIPTION a 
Aimag returns the imaginary part of its single-precision complex 
argument. Dimag returns the double-precision imaginary part of its 
double-complex argument. 
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_ NAME 


aint, dint — Fortran integer part intrinsic function 


SYNOPSIS 
real r1, r2 
double precision dp1, dp2 


r2 = aint(r1) 


dp2 = dint(dp1) 
dp2 = aint(dp1) 


DESCRIPTION 
Aint returns the truncated value of its real argument in a real. Dint 
returns the truncated value of its double-precision argument as a 
double-precision value. Aint may be used as a generic function 
name, returning either a real or double-precision value depending on 
the type of its argument. 


| 
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NAME 

asin, dasin — Fortran arcsine intrinsic function 
SYNOPSIS 

real r1, r2 


double precision dp1, dp2 
r2 = asin(r1) 


dp2 = dasin(dp1) 
dp2 = asin(dp1) 


DESCRIPTION 


ASIN(3F) 


Asin returns the real arcsine of its real argument. Dasin returns the 
double-precision arcsine of its double-precision argument. The gen- 
eric form asin may be used with impunity as it derives its type from 


that of its argument. 


SEE ALSO 
trig(3M). 
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NAME 
atan, datan — Fortran arctangent intrinsic function 


SYNOPSIS 
real r1, r2 
double precision dp1, dp2 


r2 = atan(r1) 


dp2 datan(dp1) 
dp2 = atan(dp1) 


DESCRIPTION 
Atan returns the real arctangent of its real argument. Datan returns 
the double-precision arctangent of its double-precision argument. 
The generic form atan may be used with a double-precision argu- 
ment returning a double-precision value. 


SEE ALSO 
trig(3M). 


il 


| 
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NAME 
atan2, datan2 — Fortran arctangent intrinsic function 


SYNOPSIS et eas 
real r1, r2, r3 
double precision dp1, dp2, dp3 


r3 = atan2(r1, r2) 


dp3 datan2(dp1, dp2) | 
dp3 = atan2(dp1, dp2) | 


DESCRIPTION , a ae 
Atan2 returns the arctangent of arg1/arg2 as a real value. Datan2 
returns the double-precision arctangent of its double-precision argu- 
ments. The generic form atan2 may be used with impunity with 
double-precision arguments. 


SEE ALSO 
trig(3M). 


i 
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NAME 


and, or, xor, not, Ishift, rshift — Fortran bitwise boolean functions 


SYNOPSIS 


integer i, j, k 
real a, b, c | 
double precision dpi, dp2, dp3 


= and(i, j) 
or(a, b) 
= xor(i, a) 
= not(i) 
Ishift(i, j) 
k = rshift(i, j) 


| 


k 
Cc 
k 


DESCRIPTION 


NOTE 


BUGS 
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The generic intrinsic boolean functions and , or and xor return the 
value of the binary operations on their arguments. Not is a unary 
operator returning the one’s complement of its argument. Lshift and 
rshift return the value of the first argument shifted left or right, 
respectively, the number of times specified by the second (integer) 
argument. | 


The boolean functions are generic, that is, they are defined for all 
data types as arguments and return values. Where required, the 
compiler will generate appropriate type conversions. 


Although defined for all data types, use of boolean functions on any 
but integer data is bizarre and will probably result in unexpected 
consequences. 


The implementation of the shift functions may cause large shift 
values to deliver weird results. 
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NAME 
conjg, dconjg — Fortran complex conjugate intrinsic function 
SYNOPSIS oe 
complex cx1, cx2 
double complex dx1, dx2 
Cx2 = conjg(cx1) 
dx2 


DESCRIPTION 


Conjg returns the complex conjugate of its complex argument. 
Deonjg returns the double-complex conjugate of its double-complex 
argument. | 


| 


dconjg(dx1) 
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. NAME 


cos, dcos, ccos — Fortran cosine intrinsic function 


SYNOPSIS 
real r1, r2 
double precision dp1, dp2 
complex cx1, cx2 


r2 = cos(r1) 


dp2 = dcos(dp1) 
dp2 = cos(dp1) 


cx2 = ccos(cx1) 
cx2 = cos(cx1) 


DESCRIPTION 
Cos returns the real cosine of its real argument. Dcos returns the 
double-precision cosine of its double-precision argument. Ccos 
returns the complex cosine of its complex argument. The generic 
form cos may be used with impunity as its returned type is deter- 
mined by that of its argument. 


SEE ALSO 
trig(3M). 
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NAME | a 
cosh, dcosh — Fortran hyperbolic cosine intrinsic function ° \ 

SYNOPSIS a 
real r1, r2 


double precision dp1, dp2 
r2 = cosh(r1) 
dp2 = dcosh(dp1) 
dp2 = cosh(dp1) 
DESCRIPTION ahs 
Cosh returns the real hyperbolic cosine of its real argument. Dcosh 
returns the double-precision hyperbolic cosine of its double-precision 


argument. The generic form cosh may be used to return the hyper- 
bolic cosine in the type of its argument. 


SEE ALSO 
sinh(3M). 
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NAME 
dim, ddim, idim — positive difference intrinsic functions 


SYNOPSIS 
integer a1,a2,a3 
a3 = idim(al,a2) 


real a1,a2,a3 
a3 = dim(a1,a2) 


double precision a1,a2.,a3 
a3 = ddim(at1,a2) 


DESCRIPTION 
These functions return: 
ai-a2 ifai > a2 
O ifail <= a2 
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NAME es 
dprod — double precision product intrinsic function ( 


SYNOPSIS a 
real a1,a2 
double precision a3 
a3 = dprod (al,a2) 


DESCRIPTION 
Dprod returns the double precision product of its real arguments. 
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NAME 


exp, dexp, cexp — Fortran exponential intrinsic function 


SYNOPSIS 


real r1, r2 
double precision dp1, dp2 
complex cx1, cx2 


r2 = exp(rt) 
dp2 = dexp(dp1) 
dp2 = exp(dp1) 
cx2 = clog(cx1) 
cx2 = exp(cx1) 


DESCRIPTION 


Exp returns the real exponential function e” of its real argument. 
Dexp returns the double-precision exponential function of its 
double-precision argument. Cexp returns the complex exponential 
function of its complex argument. The generic function exp 
becomes a call to dexp or cexp as required, depending on the type 
of its argument. 


SEE ALSO 
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exp(3M). 
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NAME 


SYNOPSIS 


UNIX Sys5 


integer i, } 

real r, s 

double precision dp, dq 
complex cx 

double complex dcx 
character*7 ch 


i = int(r) 
i = int(dp) 
i = int(cx) 
i = int(dex) 
i = ifix(r) 
i = idint(dp) 
r = real(i) 
r = real(dp) 
r = real(cx) 
r = real(dcx) 
r = float(i) 
r = sngl(dp) 
dp = dbie(i) 
dp = dble(r) 
dp = dble(cx) 
dp = dbie(dcx) 
cx = cmplx(i) 
cx = cmplx(i, j) 
cx = cmplx(r) 
cx = cmplx(r, s) 
cx = cmplx(dp) 
cx = cmplx(dp, dq) 
cx = cmplx(dcx) 
dcx = dcmpix(i) 
dcx = demplkx(i, j) 
dex = dcmplx(r) 
dcx = dcmpix(r, s) 
dcx = dcmplx(dp) 
dcx = dcmplix(dp, dq) 
dex = dcmplx(cx) 
i = ichar(ch) 
ch = char(i) 
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int, ifix, idint, real, float, sngl, dble, cmplx, domplx, ichar, char - | 
explicit Fortran type conversion 
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DESCRIPTION 


These functions perform conversion from one data type to another. 


The function int converts to integer form its real, double precision, 
complex, or double complex argument. If the argument is real or 
double precision. int returns the integer whose magnitude is the 
largest integer that does not exceed the magnitude of the argument 
and whose sign is the same as the sign of the argument (1.e. trunca- 
tion). For complex types, the above rule is applied to the real part. 
ifix and idint convert only rea/ and double precision arguments 
respectively. 


The function real converts to rea/ form an integer, double precision, 
complex, or double complex argument. If the argument is double 
precision or double complex, as much precision is kept as Is possi- 
ble. If the argument is one of the complex types, the real part is 
returned. float and sngl convert only integer and double precision 
arguments respectively. 


The function dble converts any integer, real, complex, or double 
complex argument to double precision form. If the argument is of a 
complex type, the real part is returned. 


The function cmplx converts its integer, real, double precision, or 
double complex argument(s) to complex form. 


The function dcmplx converts to double complex form its integer, 
real, double precision, or complex argument(s). 


Either one or two arguments may be supplied to cmpIx and dcemplx 
. If there is only one argument, it is taken as the real part of the 
complex type and an imaginary part of zero is supplied. If two argu- 
ments are supplied, the first is taken as the real part and the second 
as the imaginary part. 


The function ichar converts from a character to an integer depend- 
ing on the character's position in the collating sequence. 


The function char returns the character in the /th position in the pro- 
cessor collating sequence where / is the supplied argument. 


For a processor capable of representing n characters, 
ichar(char(i)) = | forO0 <= |< n, and 


char(ichar(ch)) = ch for any representable character ch. 
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NAME 
getarg — return Fortran command-line argument 


SYNOPSIS 
character*N c 
integer i 
getarg(i, c) 


- DESCRIPTION | 
Getarg returns the / -th command-line argument of the current pro- 
cess. Thus, if a program were invoked via 


foo arg1 arg2 arg3 


getarg(2, c) would return the string “arg2” in the character variable 
om 


SEE ALSO 
getopt(3C). 
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NAME 
getenv — return Fortran environment variable 


SYNOPSIS 
character*N c 


getenv("TMPDIR", c) 


DESCRIPTION 
Getenv returns the character-string value of the environment vari- 
able represented by its first argument into the character variable of 
its second argument. If no such environment variable exists, all 
blanks will be returned. 


SEE ALSO 
getenv(3C), environ(5). 
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NAME 
large 


SYNOPSIS 
integer i Seay SB 
i = iargc() a 


DESCRIPTION | 
The /argc function returns the number of command line arguments 
passed to the program. Thus, if a program were invoked via 


foo arg1 arg2 arg3 - 


iargc() would return “3”. 


SEE ALSO 
getarg(3F). 
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NAME 
index — return location of Fortran substring 


SYNOPSIS 
character*N1 ch1 
character+N2 ch2 
integer i 


i = index (ch1, ch2) 


DESCRIPTION 
Index returns the location of substring ch2 in string ch? . The value 
returned is the position at which substring ch2 starts, or 0 is it is not 
present in string ch7 . 
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NAME 


_— len — return length of Fortran string 


SYNOPSIS cad 
character*N ch 
integer i 


1 = len(ch) 


DESCRIPTION _ 
Len returns the length of string ch . 
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~ NAME 
log, alog, dlog, clog — Fortran natural logarithm intrinsic function 
SYNOPSIS 
real r1, r2 


double precision dp1, dp2 
complex cx1, cx2 
r2 = alog(r1) 
r2 = log(r1) 
dp2 = dlog(dp1) 
dp2 = log(dp1) 
cx2 = clog(cx1) 
cx2 = log(cx1) 
DESCRIPTION 

Alog returns the real natural logarithm of its real argument. Dilog 
returns the double-precision natural logarithm of its double-precision 
argument. C/og returns the complex logarithm of its complex argu- 
ment. The generic function jog becomes a call to alog , dlog , or 
clog depending on the type of its argument. 

_.. SEE ALSO 

exp(3M). 
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NAME 
log10, alog10, dlog10 — Fortran common logarithm intrinsic function 


SYNOPSIS 
real r1, r2 
double precision dp1, dp2 
r2 = alog10(r1) 
r2 = logi0(r1) 
dp2 = dlog10(dp1) 
dp2 = 1logi0(dp1) 
DESCRIPTION 
Alog10 returns the real common logarithm of its real argument. 


Diog10 returns the double-precision common logarithm of its — 


double-precision argument. The generic function jog10 becomes a 
call to alog?10 or dlog10 depending on the type of its argument. 


SEE ALSO 
exp(3M). 
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NAME 
( | max, max0, amax0O, max1, amax1, dmax1 — Fortran maximum-value 
: functions 


SYNOPSIS 
integer i, j, k, | 
real a, b, c, d 
double precision dp1, dp2, dp3 
| = max(i, j, k) 
c = max(a, b) 
dp = max(a, b, c) 


k = max0O(i, j) 
a = amax0O(i, j, k) 
| = maxi(a, b) 


d = amaxt(a, b, c) 
dp3 = dmaxt(dp1, dp2) 


DESCRIPTION 

The maximum-value functions return the largest of their arguments 
(of which there may be any number). Max is the generic form 
which can be used for all data types and takes its return type from 
that of its arguments (which must all be of the same type). Max0 
pte returns the integer form of the maximum value of its integer argu- 
( ments; amaxO , the real form of its integer arguments; max7 , the 
integer form of its real arguments; amax7 , the real form of its real 
arguments; and dmax7 , the double-precision form of its double- 

precision arguments. 


SEE ALSO 
min(3F). 
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NAME , 
-mclock — return Fortran time accounting 


SYNOPSIS 
integer i 


i = mclock( ) 


DESCRIPTION | 
Mclock returns time accounting information about the current pro- 
cess and its child processes. The value returned is the sum of the 
current process's user time and the user and system times of all 
child processes. 


SEE ALSO 
times(2), clock(3C), system(3F). 
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( NAME 
= min, mind, aminO, mint, amini, dmini — Fortran minimum-value 


functions 


SYNOPSIS 


integer i, j, k, | 
real a, b, c, d 
double upeeeion dp1, dp2, dp3 


| = 

c = min(a, b) 

dp = min(a, b, c) 
k = minO(i, j) 

a = aminQO(i, j, k) 

i = mint(a, b) 

d = amin{(a, b, c) 
dp3 = dmini(dp1, dp2) 


DESCRIPTION 


The minimum-value functions return the minimum of their arguments 
(of which there may be any number). Min is the generic form which 
can be used for all data types and takes its return type from that of 
its arguments (which must all be of the same type). MinO returns 
the integer form of the minimum value of its integer arguments; 
amino , the real form of its integer arguments; min? , the integer 
form of its real arguments; amin? , the real form of its real argu- 
ments; and dmin7 , the double-precision form of its double-precision 
arguments. 


SEE ALSO 


Page 1 


max(3F). 
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NAME 


mod, amod, dmod — Fortran remaindering intrinsic functions ‘<7 


SYNOPSIS 


integer i, j, k 

real r1, r2, r3 

double precision dp1, dp2, dp3 
k = mod(i, j) 

r3 = amod(r1, r2) 

r3 = mod(r1, r2) 

dp3 = dmod(dp1, dp2) 

dp3 = mod(dp1, dp2) 


I 


DESCRIPTION 
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Mod returns the integer remainder of its first argument divided by its 
second argument. Amod and dmod return, respectively, the real 
and double-precision whole number remainder of the integer division 
of their two arguments. The generic version mod will return the 
data type of its arguments. 
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NAME 


irand, rand, srand — random number generator 
SYNOPSIS 

call srand(iseed) 

i = irand() 

x = rand( ) 
DESCRIPTION 


lrand generates successive pseudo-random numbers in the range 

from 0 to 2**15-1. Rand generates pseudo-random numbers distri- 

buted in (0, 1.0). Srand uses its integer argument to re-initialize the ~ 

seed for successive invocations of irand and rand . 
SEE ALSO 

rand(3C). 
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a eas 
NAME 
anint, dnint, nint, idnint — Fortran nearest integer functions aed 
SYNOPSIS 
integer i 
real r1, r2 


double precision dp1, dp2 


r2 = anint(r1) 
i = nint(r1) 


dp2 = anint(dp1) 
dp2 = dnint(dp1) 


i = nint(dp1) 
i = idnint(dp1) 


DESCRIPTION 
Anint returns the nearest whole real number to its real argument 
(i.e., int(a+0.5) if a = O, int(a—0.5) otherwise). Dnint does the same 
for its double-precision argument. Nint returns the nearest integer 
to its real argument. /dnint is the double-precision version. Anint is 
the generic form of anint and dnint , performing the same operation 
and returning the data type of its argument. Nint is also the generic ~~ 


form of idnint. . 
——_, 
Lue 
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NAME 


sign, isign, dsign — Fortran transfer-of-sign intrinsic function 


SYNOPSIS 


integer i, j, k 

real r1, r2, r3 | 
double precision dp1, dp2, dp3 
k = isign(i, j) 

k = sign(i, J) 

r3 = sign(r1, r2) 

dp3 = dsign(dp1, dp2) 

dp3 = sign(dp1, dp2) 


DESCRIPTION 


Paae 1 


Isign returns the magnitude of its first argument with the sign of its 
second argument. Sign and dsign are its real and double-precision 
counterparts, respectively. The generic version is sign and will 
devolve to the appropriate type depending on its arguments. 
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— 
NAME \ Zy 
signal — specify Fortran action on receipt of a system signal oe 
SYNOPSIS 
integer i 


external integer intfnc 
call signal(i, intfnc) 


DESCRIPTION 
Signal allows a process to specify a function to be invoked upon 
receipt of a specific signal. The first argument specifies which fault 
or exception; the second argument the specific function to be 
invoked. 


SEE ALSO 
kill(2), signal(2). 


J 
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( NAME 
= sin, dsin, csin — Fortran sine intrinsic function 


SYNOPSIS 
real r1, r2 
double precision dp1, dp2 
complex cx1, cx2 


r2 = sin(rt) 


dp2 = dsin(dp1) 
dp2 = sin(dp1) 
cx2 = csin(cx1) 
cx2 = sin(cx1) 

DESCRIPTION 
Sin returns the real sine of its real argument. Dsin returns the 
double-precision sine of its double-precision argument. Csin returns 
the complex sine of its complex argument. The generic sin function 
becomes dsin or csin as required by argument type. 


SEE ALSO 
trig(SM). 
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NAME 
sinh, dsinh — Fortran hyperbolic sine intrinsic function 


SYNOPSIS 
real r1, r2 
double precision dp1, dp2 


r2 = sinh(r1) 
dp2 = dsinh(dp1) 
dp2 = sinh(dp1) 


DESCRIPTION 
Sinh returns the real hyperbolic sine of its real argument. Dsinh 
returns the double-precision hyperbolic sine of its double-precision 
argument. The generic form sinh may be used to return a double- 
precision value when given a double-precision argument. 


SEE ALSO 
sinh(3M). 
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( - NAME 


sqrt, dsqrt, csqrt — Fortran square root intrinsic function 


SYNOPSIS 


real r1, r2 

double precision dp1, dp2 
complex cx1, cx2 

r2 = sqrt(r1) 

dp2 = dsqrt(dp1) 

dp2 sqrt(dp1) 

cx2 = csqrt(cx1) 

cx2 = sqrt(cx1) 


I 


DESCRIPTION 


Sqrt returns the real square root of its real argument. Dsqrt returns 
the double-precision square root of its double-precision argument. 
Csqrt returns the complex square root of its complex argument. 
Sqrt , the generic form, will become dsqrt or csqrt as required by its 
argument type. 


SEE ALSO 
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exp(3M). 
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NAME 
Ige, Igt, lle, Ilt — string comparision intrinsic functions 


SYNOPSIS 
character*N al, a2 
logical | 


= Ige (a1,a2) 
= Igt (al,a2) 
lle (a1,a2) 
= fit (a1,a2) 


DESCRIPTION 


| 


STRCMP(3F) 


These functions return .TRUE. if the inequality holds and .FALSE. 


otherwise. 
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—. NAME 


system — issue a shell command from Fortran 


SYNOPSIS 
character*N c 


call system(c) 


DESCRIPTION 
System causes its character argument to be given to sh (7) as 
input, as if the string had been typed at a terminal. The current pro- 
cess waits until the shell has completed. 


SEE ALSO 
exec(2), system(3S). 
sh(1) in the Sys5 UNIX User Reference Manual. 
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NAME 

tan, dtan — Fortran tangent intrinsic function 
SYNOPSIS 

real r1, r2 

double precision dp1, dp2 

r2 = tan(r1) 


dp2 = dtan(dp1) 
dp2 = tan(dp1) 


DESCRIPTION 


TAN(3F) 


Tan returns the real tangent of its real argument. Dfan returns the 
double-precision tangent of its double-precision argument. The gen- 
eric tan function becomes atan as required with a double-precision 


argument. 


SEE ALSO 
trig(3M). 
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NAME 
tanh, dtanh — Fortran hyperbolic tangent intrinsic function 


SYNOPSIS 
real r1, r2 
double precision dp1, dp2 
r2 = tanh(r1) 
dp2 - dtanh(dp1) 
dp2 = tanh(dp1) 
DESCRIPTION 
Tanh returns the real hyperbolic tangent of its real argument. Dtanh 
returns the double-precision hyperbolic tangent of its double- 


precision argument. The generic form fanh may be used to return a 
double-precision value given a double-precision argument. 


SEE ALSO 
sinh(3M). 
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NAME 
(_ intro — introduction to file formats 
\-_ DESCRIPTION 
7 This section outlines the formats of various files. The C struct 
declarations for the file formats are given where applicable. Usually, 


these structures can be found in the directories /usr/include or 
/usr/include/sys . 


References of the type name (1M) refer to entries found in Section 
1 of the "UNIX System Administrator Reference Manual" . 
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NAME 
L-devices — link devices, connection information 
DESCRIPTION _ 
The file /usr/lib/uucp/L-devices contains information for terminal port 
configuration and for dialer and hardwired connections that UUCP 
needs to call other systems. This information is coded directly into 
the UUCP programs. 
The following is the format for an entry describing a hardwired port 
configuration: 
DIR device 0 baud 
The 0 indicates a direct connection. 
To describe an Automatic Call Unit (modem) connection, use the 
format: 
ACU device modem baud 
The modem or cable port must be described in this file and each 
device in the file must also be in the directory /dev, with an owner- 
ship of uucp. 
SEE ALSO 
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L.sys(4), getty(1m). 
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NAME 


L-dialcodes — alphabetic dialing abbreviations file 


DESCRIPTION 


The file /usr/lib/uucp/L-dialcodes contains alphabetic abbreviations 
for dialing strings. The dialing strings are typically area codes, pre- 
fixes, and outside line access digits, but can contain the entire tele- 
phone number as well as any other dialable digits. The strings can 
also contain special dialing characters: an equals sign (=) tells the 
dialer to wait for a secondary dial tone (helpful for dialing from busi- 
ness communications sytems); a dash (—) tells the dialer to pause 
for one second before dialing the next digit. 


The alphabetic abbreviation is entered in the telephone number field 
of the /usr/lib/uucp/L.sys file. Dialable digits can follow the dialing 
abbreviation in this file. A sample /usr/lib/uucp/L.sys file might look 
like the following: 


NJ 9 = 201 834 
IL 9 = 312 982 


The abbreviations reference the digits to dial the area code and pre- 
fix for New Jersey or Illinois. 


- SEE ALSO 


~~ 
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L.sys(4). 
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NAME 
L.cmds — remote execution commands 


DESCRIPTION al 
The file /usr/lib/uucp/L.cmds contains commands needed by the 
UUCP remote command execution program uux. Its format is one 
command per line. 


A system administrator should be careful which files are put into the 
L.cmds file. At a minimum, it should contain rmail. Other sugges- 
tions are rnews, /pr, and who. Commands like cat(1), cp(1), rm(1), 
or uucp(ic) should not be included. To do so would allow remote 
users to override security restrictions. 


The safest list would allow remote users to look around the 
/usr/spool/uucppublic directory and to print files on a remote printer, 
but not allow them to move files onto their system. 


The /usr/lib/uucp/L.cmds file looks like the following: 


HEHHHHAAHEH#F Lomds F#####FFFFHEE 
# 

# 

# This is a list of commands that 

# can be executed by uux. | 
rmail 
who 
lpr 
more 


SEE ALSO 
USERFILE(4), uucico(1m), uuxqt(1m), uucp(ic). 
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NAME 
L.sys — link systems 


DESCRIPTION 
The file /usr/lib/uccp/L.sys contains the following information that 
uucp must have for each system that is to be linked: 


uucp login name 
uucp password 
Phone number of modem 


Each system connected to the local uucp programs has a line entry 
in the L.sys file. Syntax is as follows: 


sysname time device baud phone# (logininfo) 


The sysname field is the name of the system to be called, as 
entered using the dconfig(im) command.. 


The time field consists of the day and time this system is available 
for incoming calls, and an option of a minimum retry time for calling 
back when a call does not go through. 


Days of the week can be specified with the following abbreviations: 
Mo, Tu, We, Th, Fr, Sa, Su, or Wk for any weekday. Time-of-day 
is indicated with a 24-hour clock. A range can be given, separating 
the times with a dash. If the system is available at all times the 
word Any can be used. If the system can call, but cannot be called, 
you can use Never and uucp requests will be queued. The day and 
time-of-day fields are not separated by a space. 


Calls that come in at times other than those specified in the time 
field are batched and executed at the specified time. By default, the 
system waits 55 minutes before trying a connection after a failure. 
To change the default time, enter the new time (minimum of five 
minutes) after the day specification, separated by a comma. 


The device is ACU or the name of the device to use, such as tty0. 
baud is the baud rate of the device being called. 


phone# is the phone number of the system being called. A one- 
second pause is indicated by a dash (-—), and a wait for a dial-tone is 
indicated by an equals sign (=). A dial code can also be entered in 
this field. If a direct line is being used, this entry is the save as dev- 
ice. 


The /ogininfo is optional information that the local system expects to 
receive from the remote system and what should be sent in reply 
during login. 


L-dialcodes(4), uucp(1c). 
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WARNING | ~~ 


Only the first six characters of a system-name are significant. Any 
excess characters are ignored. ed 
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_ NAME 


USERFILE — UUCP pathname permissions file 


— DESCRIPTION 


Page 1 


USERFILE specifies the file system directory trees that are accessi- 
ble to local users and to remote systems via UUCP. 


Each line in USERFILE is of the form: 
user, [ system ] [ c ] pathname [ pathname ... ] 


The first two items are separated by a comma; any number of 
spaces or tabs may separate the remaining items. Lines beginning 
with a ‘#’ character are comments. 


User is a login (from /etc/passwd) on the local machine. Every 
login name that is used by remote systems to connect for UUCP 
transfers must be listed. 


The optional System is the name of a remote machine, the same 
name used in L.sys(4). 


c denotes the optional ca//back field. If a « appears here, a remote 
machine that calls in will be told that callback is requested, and the 
conversation will be terminated. The local system will then immedi- 
ately call the remote host back. 


Pathname is a pathname prefix that is permissible for this login 
and/or system. 


When uucico(1M) runs in master role or uucp(1C) or uux(1C) are 
run by local users, the permitted pathnames are those on the first 
line with a joginname that matches the name of the user who exe- 
cuted the command. If no such line exists, then the first line with a 
null (missing) loginname field is used. (Beware: uucico is often run 
by the superuser or the UUCP administrator through cron(1M).) 


When uucico runs in slave role, the permitted pathnames are those 
on the first line with a system field that matches the hostname of the 
remote machine. If no such line exists, then the first line with a null 
(missing) system field is used. 

Uuxqt(1M) works differently; it knows neither a login name nor a 
hostname. It accepts the pathnames on the first line that has a null 
system field. (This is the same line that is used by uucico when it 
cannot match the remote machine's hostname.) 


A line with both foginname and system null, for example 
; /usr/spool/uuc ppublic 


is termed a "null line.” It specifies the paths for whichever of the 
"unknown login name" or the "unknown hostname” cases was not 
defined earlier in the file. If neither has been defined, then only the 
"unknown login name" case will be defined. Note that it is 
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FILES 
/usrfib/uucp/USERFILE 

SEE ALSO 
uucp(1C), uux(1C), L.cmds(4), L.sys(4), L—dialcodes(4), 
L—devices(4), uucico(1M), uuxqt(1M). 

NOTES 
The UUCP utilities (uucico, uucp, uux, and uuxagt) always have 
access to the UUCP spool files in /usr/spool/uucp, regardless of 
pathnames in USERFILE. 
If uucp is listed in L.cmds(4), then a remote system will execute 
uucp on the local system with the USERFILE privileges for its login, 
not its hostname. 
Uucico freely switches between master and slave roles during the 
course of a conversation, regardless of the role with which it was 
started. This affects how USEARFILE is interpreted. 

WARNING 
USERFILE restricts access only on strings that the UUCP utilities ,~ 
identify as being pathnames. If the wrong holes are left in other : 
UUCP control files (notably L.cmds), it can be easy for an intruder to 
open files anywhere in the file system. Arguments to uucp(1C) are 
safe, since it assumes all of its non-option arguments are file 
names. Uux(1C) cannot make such assumptions; hence, it is more 
dangerous. 

BUGS 


unacceptable to have a USERFILE consisting of nothing but a “null 


line": this will leave the "unknown hostname" case undefined and, a 


will cause uuxat to reject all requests. 


The current user's name is determined via the getpwent(3C) func- 
tion call; hence, if several names are assigned to a single UID, the 
first name encountered in /etc/passwd will be used. 


Older versions of uuxgt(1M) erroneously check UUCP spool files 
against the USERFILE pathname permissions. Hence, on these 
systems it is necessary to specify /usr/spool/uucp as a valid path 
on the USERFILE line used by uuxgt. Otherwise, all uux(iC) 
requests are rejected with a "PERMISSION DENIED" message. 


Only the first six characters of a system-name are significant. Any 
excess characters are ignored. 
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NAME 


a.out — common assembler and link editor output 


DESCRIPTION 


Page 1 


The file name a.out is the output file from the assembler as (7) and 
the link editor /d (7). Both programs will make a.out executable if 
there were no errors in assembling or linking and no unresolved 
external references. 


A common object file consists of a file header, a UNIX system 
header, a table of section headers, relocation information, (optional) 
line numbers, and a symbol table. The order is given below. 


File header. 
UNIX system header. 
Section 1 header. 


Section n header. 
Section 1 data. 


Section n data. 
Section 1 relocation. 


Section n relocation. 
Section 1 line numbers. 


Section n line numbers. 
Symbol table. 
String table. 


The last four sections (relocation, line numbers, symbol table and 
string table) may be missing if the program was linked with the -s 
option of /d (7) or if the symbol table and relocation bits were 
removed by strip (1). Also note that if there were no unresolved 
externa! references after linking, the relocation information will be 
absent. The string table exists only if necessary. 


The sizes of each segment (contained in the header, discussed 
below) are in bytes and are even. 


When an a.out file is loaded into memory for execution, three logical 
segments are set up: the text segment, the data segment (initialized 
data followed by uninitialized, the latter actually being initialized to all 
O's), and a stack. The text segment begins at location 0 in the core 
image. The header is never loaded. If the magic number (the first 
field in the UNIX system header) is 407 (octal), it indicates that the 
text segment is not to be write-protected or shared, so the data seg- 
ment will be contiguous with the text segment. If the magic number 
is 410 (octal), the data segment and the text segment are not 
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writable by the program; if other processes are executing the same 
a.out file, the processes will share a single text segment. 


The value of a word in the text or data portions that is not a refer- 
ence to an undefined external symbol is exactly the value that will 
appear in memory when the file is executed. If a word in the text 
involves a reference to an undefined external symbol, the storage 
class of the symbol-table entry for that word will be marked as an 
“external symbol’, and the section number will be set to 0. When 
the file is processed by the link editor and the external symbol 
becomes defined, the value of the symbol will be added to the word 
in the file. 


File Header 
The format of the filehdr header is 


struct filehdr 


{ 
unsigned short f_magic; /* magic number */ 
unsigned short f_nscns; /* number of sections */ 


long f_timdat; /* time and date stamp */ 
long f_symptr; /* file ptr to symtab */ 
long f_nsyms; /* # symtab entries */ 


unsigned short f_opthdr; /* sizeof(opt hdr) +/ 
unsigned short f_flags;  /* flags */ 


1. 
if) 


UNIX System Header 
The format of the Sys5 UNIX system header is 


typedef struct aouthdr 


{ 
short magic; /* magic number */ 
short — vstamp; /* version stamp */ 
long tsize; /* text size in bytes, padded */ 
long dsize; /* initialized data (.data) «/ 
long bsize; /* uninitialized data (.bss) */ 
long entry; /* entry point «/ 
long text_start; /* base of text this file «/ 
long data_start; /* base of data this file «/ 

} AOUTHDR; 


Section Header 
The format of the section header is 
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struct scnhdr 


{ 
char S_name[SYMNMLEN];/* section name */ 
long S_paddr; /* physical address */ 
long s_vaddr; /* virtual address «/ 
long S_size; /*« section size */ 
long s_scnptr; /* file ptr to raw data */ 
long s_relptr; /* file ptr to relocation */ 
long s_Innoptr; /* file ptr to line numbers */ 
unsigned short s_nreloc; /* # reloc entries */ 
unsigned short s_ninno; /* # line number entries */ 
long S_ flags;  /* flags */ 

}; 

Relocation 


Object files have one relocation entry for each relocatable reference 
in the text or data. If relocation information is present, it will be in 
the following format: 


struct reloc 


{ 
long r_vaddr; _/* (virtual) address of reference */ 
a long r_symndx; /* index into symbol table «/ 
( unsigned short r_type;/* relocation type «/ 


Js 
The start of the relocation information is s_re/ptr from the Section 
Header. lf there is no relocation information, s_refptr is 0. 


Symbol Table 
The format of the symbol table header is 


#define SYMNMLEN 8 
#define FILNMLEN' 14 
#define SYMESZ 18 /* the size of a SYMENT */ 


struct syment 


{ 
union /* all ways to get sym name */ 
{ 
char _nh_name[SYMNMLEN]; /* name of symbol */ 
struct 
{ 
long _n_zeroes; /* == OL if in string table «/ 
oe long _h_offset; = /* location in string table */ 
( ’ } _n_n; 
—, char * N_nptr[2]; /* allows overlaying «/ 
} _n; 
unsigned long n_value; /* value of symbol */ 
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short n_scnum; __/* section number «/ ae 
unsigned short —_—n_type; /* type and derived type + 
char n_sclass; _/* storage class */ Meg? 
char n_numaux; /* number of aux entries «/ 

I 

#define n_name _n._n_name 

#define n_zeroes _n._n_n._n_zeroes 

#define n_offset _n._n_n._n_offset 

#define n_nptr _n._n_nptr[1] 


Some symbols require more information than a single entry; they 
are followed by auxiliary entries that are the same size as a symbol 
entry. The format follows. 


union auxent { 


struct { 
long. x_tagndx; 
union { 
struct { 
unsigned short x_Inno; 
unsigned short x_size; 
} x_Insz; pos 
long x_fsize; | ; 
\ x_misc; a 
union { 
struct { 
long = x_Innoptr; 
long x_endndx; 
} x_fen; 
struct { 
unsigned short x_dimen[DIMNUM]; 
} X_ary; 
} x_fenary; 
unsigned short x_tvndx; 
} x_sym; 
struct { 
char x_fname[FILNMLEN]}; 
} x_file; 
struct { 
long x_scnien; 
unsigned short x_nreloc; fo™ 
unsigned short x_nlinno; en 
} x_scn; 
struct { 


May 13, 1986 Page 4 


A.OUT (4) UNIX Sys5 A.QUT(4) 


long x_tvfill; 

unsigned short x_tvien; 

unsigned short x_tvran[2]; 

} x_tv; 
b; 

Indexes of symbol table entries begin at zero . The start of the sym- 
bol table is f_symptr (from the file header) bytes from the beginning 
of the file. If the symbol table is stripped, f_symptr is 0. The string 
table (if one exists) begins at f_symptr + ( f_nsyms * SYMESZ) 
bytes from the beginning of the file. 


SEE ALSO 
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brk(2), filehdr(4), Idfen(4), linenum(4), reloc(4), scnhdr(4), syms(4). 
as(1), cc(1), Id(1) in the Sys5 UNIX User Reference Manual. 
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-. NAME 
( acct — per-process accounting file format 


SYNOPSIS 
#include <sys/acct.h> 


DESCRIPTION : 
Files produced as a result of calling acct (2) have records in the 
form defined by <sys,acct.h> , whose contents are: 


typedef ushort comp_t; .* “floating point” «: 
** 13-bit fraction, 3-bit exponent *; 


struct acct 


{ 
char —ac_flag; »* Accounting flag */ 
char —__ac_stat; i* Exit status */ 
ushort ac_uid; 
ushort ac_gid; 
dev_t  ac_tity; 
time_t ac_btime; »* Beginning time */ 
comp_t ac_utime; “* acctng user time in clock ticks */ 
7 comp_t ac_stime; -* acctng system time in clock ticks */ 
( | comp_t ac_etime; — ,* acctng elapsed time in clock ticks «/ 
| comp_t ac_mem; /* memory usage in clicks *: 
comp_t ac_io; /* Chars trnsfrd by read/write *, 
comp_t ac_rw; i number of block reads/writes */ 
char  ac_comm|8]; /* command name */ 
p 
extern struct acct acctbuf; 
extern struct inode *acctp; :* inode of accounting file «, 
#define AFORK 01 /* has executed fork, but no exec «, 
#define ASU 02 /* used Super-user privileges *., 
#define ACCTF 0300 /* record type: OO = acct *: 


In ac_flag , the AFORK flag is turned on by each fork (2) and turned 
off by an exec (2). The ac_comm field is inherited from the parent 
process and is reset by any exec . Each time the system charges 
the process with a clock tick, it also adds to ac_mem the current 
process size, computed as follows: 


(data size) + (text size) » (number of in-core processes 
using text) 
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The value of ac_mem/(ac_stime + ac_utime) can be | 
viewed as an approximation to the mean process size, as_ 


modified by text-sharing. 


SEE ALSO 
acct(2), exec(2), fork(2). 
acct(1M) in the Sys5 UNIX Administrator Reference Manual. 
acctcom(1) in the Sys5 UNIX User Reference Manual. 


BUGS 
The ac_mem value for a short-lived command gives little information 
about the actual size of the command, because ac_mem may be 
incremented while a different command (e.g., the shell) is being 
executed by the process. 
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NAME 
ar — common archive file format 


DESCRIPTION 
The archive command ar (7) is used to combine several files into 
one. Archives are used mainly as libraries to be searched by the 
link editor /d (7). | 


Each archive begins with the archive magic string. 


#define ARMAG “!<arch>\n" /* magic string */ 
#define SARMAG 8 /* length of magic string */ 


Each archive which contains common object files (see a.out (4)) 
includes an archive symbol table. This symbol table is used by the 
link editor [d (1) to determine which archive members must be 
loaded during the link edit process. The archive symbol table (if it 
exists) is always the first file in the archive (but is never listed) and 
is automatically created and/or updated by ar. 


Following the archive magic string are the archive file members. 
Each file member is preceded by a file member header which is of 
the following format: 


( #define ARFMAG “‘\n" /* header trailer string */ 

struct ar_hdr /* file member header */ 

{ 
char ar_name[16]; /* 'f terminated file member name */ 
char ar_date[12]; /* file member date */ 
char  ar_uid[6]; /* file member user identification «/ 
char ar_gid[6]; /* file member group identification */ 
char ar_mode{8]; /* file member mode (octal) */ 
char ar_size[10}; /* file member size «/ 
char ar_fmag[2]; /* header trailer string */ 

fi 


All information in the file member headers is in printable ASCII. The 
numeric information contained in the headers is stored as decimal 
numbers (except for ar_mode which is in octal). Thus, if the archive 
contains printable files, the archive itself is printable. 


The ar_name field is blank-padded and slash (/) terminated. The 
Bus, ar_date field is the modification date of the file at the time of its 
insertion into the archive. Common format archives can be moved 
from system to system as long as the portable archive command ar 

(1) is used. | 
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Each archive file member begins on an even byte boundary; a new- | 
line is inserted between files if necessary. Nevertheless the size : 
given reflects the actual size of the file exclusive of padding. : 


Notice there is no provision for empty areas in an archive file. 


If the archive symbol table exists, the first file in the archive has a 
zero length name (i.e., ar_name[0] == '/). The contents of this file 
are as follows: 


e The number of symbols. Length: 4 bytes. 


® The array of offsets into the archive file. Length: 4 bytes * 
“the number of symbols”. 


@ The name string table. Length: ar_size — (4 bytes * (“the 
number of symbols” + 1)). 


The number of symbols and the array of offsets are managed with 
sgeti and sput!. The string table contains exactly as many null ter- 
minated strings as there are elements in the offsets array. Each 
offset from the array is associated with the corresponding name 
from the string table (in order). The names in the string table are all 
the defined global symbols found in the common object files in the 
archive. Each offset is the location of the archive header for the 
associated symbol. 


SEE ALSO 


sputl(SX), a.out(4). 
ar(1), arcv(1), Id(1), strip(1) in the Sys5 UNIX User Reference 
Manual. 


CAVEATS 


Strip (1) will remove all archive symbol entries from the header. 
The archive symbol entries must be restored via the ts option of the 
ar (1) command before the archive can be used with the link editor 
Id (1). 
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NAME 
checklist — list of file systems processed by fsck 


DESCRIPTION 
Checklist resides in directory /ete and contains a list of, at most, 15 
Special file names. Each special file name is contained on a 
separate line and corresponds to a file system. Each file system will 
then be automatically processed by the fsck (1M) command. 

SEE ALSO 
fsck(1M) in the Sys5 UNIX Administrator Reference Manual. 
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NAME 


core — format of core image file 


DESCRIPTION 


The UNIX system writes out a core image of a terminated process 
when any of various errors occur. See signal (2) for the list of rea- 
sons; the most common are memory violations, illegal instructions, 
bus errors, and user-generated quit signals. The core image is 
called core and is written in the process's working directory (pro- 
vided it can be; normal access controls apply). A process with an 
effective user ID different from the real user ID will not produce a 
core image. 


The first section of the core image is a copy of the system's per- 
user data for the process, including the registers as they were at the 
time of the fault. The size of this section depends on the parameter 
usize , which is defined in /usr/include/sys/param.h . The 
remainder represents the actual contents of the user's core area 
when the core image was written. If the text segment is read-only 
and shared, or separated from data space, it is not dumped. 


The format of the information in the first section is described by the 


user structure of the system, defined in /usr/include/sys/user.h . 
The important stuff not detailed therein is the locations of the regis- 
ters, which are outlined in /usr/include/sys/reg.h . 


SEE ALSO 
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setuid(2), signal(2). 
crash(1M) in the Sys5 UNIX Administrator Reference Manual. 
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-. NAME 
( cpio — format of cpio archive 


DESCRIPTION 
The header structure, when the —c option of cpio (7) is not used, ts: 


struct { a 
short h_magic, 

h_dev; 
ushort  h_ino, 

h_mode, 

h_uid, 

h_gid; 
short h_nlink, 

h_rdev, 

h_mtime[2], 

h_namesize, 

h_filesize[2]; 
char h_name[h_namesize rounded to word]; 
| Har; 


When the —c option is used, the header information is described by: 


ps sscanf(Chdr,"%60%60%60%60%60%60%60%60%1 1lo%6o 
( | % 11 lo%s", 
ee &Hdr.h_magic, &Hdr.h_dev, &Hdr.h_ino, &Hdr.h_mode, 
&Hdr.h_uid, &Hdr.h_gid, &Hdr.h_nlink, &Hdr.h_rdev, 
&Longtime, &Hdr.h_namesize,&Lonofile, Hdr.h_name); 


Longtime and Longfile are equivalent to Hdr.h_mtime and 
Hadr.h_filesize , respectively. The contents of each file are recorded 
in an element of the array of varying length structures, archive , 
together with other items describing the file. Every instance of 
h_magic contains the constant 070707 (octal). The items h_dev 
through h_mtime have meanings explained in stat (2). The length of 
the null-terminated path name h_name , including the null byte, is 
given by h_namesize . 


The last record of the archive always contains the name TRAILER!!!. 
Special files, directories, and the trailer are recorded with h_filesize 
equal to zero. 


SEE ALSO 
stat(2). 
cpio(1), find(1) in the Sys5 UNIX User Reference Manual. 
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dir — format of directories 
SYNOPSIS ~ 
#include <sys/dir.h> 
DESCRIPTION 
A directory behaves exactly like an ordinary file, save that no user 
may write into a directory. The fact that a file is a directory is indi- 
cated by a bit in the flag word of its i-node entry (see fs (4)). The 
structure of a directory entry as given in the include file is: 
#ifndef DIRSIZ 
#define DIRSIZ14 
#endif 
Struct direct 
J 
\ 
ino_t d_ino; 
char d_name[DIRSIZ]; 
i. 
By convention, the first two entries in each directory are for . and... 
The first is an entry for the directory itself. The second is for the 
parent directory. The meaning of .. is modified for the root directory » _ 
of the master file system; there is no parent, so.. has the same 
meaning as. . ae 
SEE ALSO 
fs(4). 
fe ™ \ 
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NAME 


dump — incremental dump tape format 


DESCRIPTION 


The dump and restor commands are used to write and read incre- 
mental dump magnetic tapes. This is a Plexus utility and not a part 
of UNIX /bin/dump. 


The dump tape consists of a header record, some bit mask records, 
a group of records describing file system directories, a group of 
records describing file system files, and some records describing a 
second bit mask. 


The header record and the first record of each description have the 
format described by the structure included by 


#include <dumprestor.h> 
This include file has the following contents: 


/* */ 

/* @(#)dumprestor.h = 1.2 2/15/85 */ 
#define NTREC 10 

#define MLEN 16 

#define MSIZ 4096 


#define TS_TAPE 
#define TS_INODE 
#define TS_BITS 
#define TS_ADDR 
#define TS_END 
#define TS_CLRI 
#define MAGIC 


Onah Wh — 


unsigned short)6001 1 


#define CHECKSUM — (short)84446 
struct spcl 
{ 

short c_type; 


time_t c_date; 

time_t c_ddate; 

short c_volume; 
daddr_t c_tapea; 

ino_t c_inumber; 
unsigned short c_magic; 
short c_checksum; 
struct dinode c_dinode; 
short c_count; 

char  c_addr[BSIZE]; 
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struct idates 


{ 
char 
char 
time_t 
ie 
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id_name[16]; 
id_incno; 
id_ddate; 


NTREC is the number of 1024 byte blocks in a physical tape record. 
MLEN is the number of bits in a bit map word. MSI/Z is the number 
of bit map words. 


The 7S_ entries are used in the c_type field to indicate what sort of 
header this is. The types and their meanings are as follows: 


TS_TYPE 
TS_INODE 
TS_BITS 
TS_ADDR 
TS_END 


TS_CLRI 


MAGIC 
CHECKSUM 


Tape volume label 


A file or directory follows. The c_dinode field is a 
copy of the disk inode and contains bits telling what 
sort of file this is. 


A bit mask follows. This bit mask has a one bit for 
each inode that was dumped. 


A subblock to a file (TS_INODE). See the description 
of c_count below. 


End of tape record. 


A bit mask follows. This bit mask contains a one bit = 


for all inodes that were empty on the file system 
when dumped. 


All header blocks have this number in c_magic. 
Header blocks checksum to this value. 


The fields of the header structure are as follows: 


c_type 
c_date 
c_ddate 
c_volume 
c_tapea 


c_inumber 


c_magic 


c_checksum 
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The type of the header. 

The date the dump was taken. 

The date the file system was dumped from. 
The current volume number of the dump. 


The current block number of this record. This is 
counting 1024 byte blocks. 


The number of the inode being dumped if this is of 
type TS_INODE. 


This contains the value MAG/C above, truncated as 
needed. | 


This contains whatever value is needed to make the . 


block sum to CHECKSUM. 
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c_dinode This is a copy of the inode as it appears on the file 
system. 


c_count This is the count of characters following that describe 
the file. A character is zero if the block associated 
with that character was not present on the file sys- 
tem, otherwise the character is non-zero. If the block 
was not present on the file system no block was 
dumped and it is replaced as a hole in the file. If 
there is not sufficient space in this block to describe 
all of the blocks in a file, TS_ADDR blocks will be scat- 
tered through the file, each one picking up where the 
last left off. 


c_addr This is the array of characters that is used as 
described above. 


Each volume except the last ends with a tapemark (read as an end 
of file). The last volume ends with a TS_END block and then the 
tapemark. 


The structure idates describes an entry of the file where dump his- 
tory is kept. | 


SEE ALSO 
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/etc/dump(1M), restor(1M). 


October 23, 1986 


wees 


ERRFILE(4) UNIX Sys5 ERRFILE(4) 


NAME 


errfile — error-log file format 


DESCRIPTION 
When hardware errors are detected by the system, an error record 
is generated and passed to the error-logging daemon for recording 
in the error log for later analysis. The default error log is 
/usr/adm/errfile . 


The format of an error record depends on the type of error that was 
encountered. Every record, however, has a header with the follow- 


ing format: 
struct errhdr { 
short e_type; /* record type */ 
short e_len; /* bytes in record (inc hdr) */ 
time_t e_time; /* time of day */ 
5 
The permissible record types are as follows: 
#define E.GOTS 010 /* start for Sys5 UNIX 
* Release 3.0*/ 
#define E.GORT O11 /* start for UNIX system/RT */ 
oe #define E_STOP 012 /* stop */ 
( | #define ETCHG 013 /* time change */ 
#define ECCHG 014 /* configuration change */ 
#define E_BLK 020 /* block device error */ 
#define ELSTRAY 030 /« stray interrupt */ 
#define E_PRTY 031 /* memory parity */ 


Some records in the error file are of an administrative nature. 
These include the startup record that is entered into the file when 
logging is activated, the stop record that is written if the daemon is 
terminated “gracefully”, and the time-change record that is used to 
account for changes in the system's time-of-day. These records 
have the following formats: 


struct estart { 


short e_Cpu; /* CPU type */ 

struct utsnamee_name; /* system names */ 

short e_mmrs3; /* contents mem mgmt reg 3 */ 
long e_syssize; /* 11/70 system memory size */ 
short e_bconf; /* block dev configuration */ 


ie 


#define eend errhdr /* record header «/ 


struct etimchg { 
time_t e_ntime; /* new time */ 
} 
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Stray interrupts cause a record with the following format to be 


ae 
a SS 
: \ 


logged: , : 
struct estray { = 
physadr e_saddr; /* stray loc or device addr «/ 
short e_sbacty;  /* active block devices */ 
}; 
Memory subsystem error causes the following record to be gen- 
erated: 
struct eccerr { 
char e_syndrome; 
char e_bconk; 


fs 
Error records for block devices have the following format: 
struct eblock { 


dev_t e_dev; /* “true” major + minor dev no */ 
physadr e_regloc; /*« controller address «/ 
short e_bacty; /* other block 1/0 activity «/ 
struct iostat { 
long iO_Ops; /* number read/writes «/ 
long io_misc; /* number “other” operations *’ ~ 
ushort io_unlog; /* number unlogged errors */ 
} e_stats; 7 
short e_bflags; /x read/write, error, etc «/ 
short e_cyloff; /* logical dev start cyl «/ 
daddr_t e_bnum; /* logical block number */ 
ushort e_bytes; /* number bytes to transfer «/ 
paddr_t e_memadd; /* buffer memory address */ 
ushort e_rtry; /* number retries «/ 
short e_nreg; /* number device registers */ 
#ifdef vax 
struct mba_regs { 
long mba_csr; 
long mba_cr; 
long mba_sr; 
long mba_var; 
long mba_vcr; 
} e_mba; 
#endif 


1 
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The following values are used in the e_bflags word: 


#define E.WRITE O /* write operation */ 
#define E_READ 1 /* read operation */ 
#define E_NOIO 02 /* no VO pending */ 
#define E_PHYS 04 _ /* physical VO */ 
#define E_MAP 010 '  /* Unibus map in use */ 
#define ELERROR 020 /* VO failed */ 


SEE ALSO 
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errdemon(1M) in the Sys5 UNIX Administrator Reference Manual. 
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filendr — file header for common object files 


SYNOPSIS 
#include <filehdr.h> 


Every common object file begins with a 20-byte header. The follow- 
ing C struct declaration is used: 


struct filehdr 


{ 
unsigned short f_magic ; /* magic number +/ 
unsigned short f_nscns ; /* number of sections */ 
long f_timdat ; /*« time & date stamp */ 
long f_symptr ; /* file ptr to symtab «/ 
long f_nsyms ; /* # symtab entries / 
unsigned short f_opthdr ; /* sizeof(opt hdr) */ 
unsigned short f_flags;  /* flags */ 

ie 


F_symptr is the byte offset into the file at which the symbol table 
can be found. Its value can be used as the offset in fseek (3S) to 
position an I/O stream to the symbol table. The UNIX system | 
optional header is 36 bytes. The valid magic numbers are given — 


below: 


#define MC68MAGIC 
#define MC68TVMAGIC 0521 


#define M68MAGIC 
#define M68TVMAGIC 0211 


0210 


0520 


The value in f_timdat is obtained from the time (2) system call. Flag 


bits currently defined are: 
F_RELFLG 


SEE ALSO 
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time(2), fseek(3S), a.out(4). 


#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 


F_EXEC 
F_LNNO 


F_LSYMS 
F_MINMAL 
F_UPDATE 
F_SWABD 
F_ARI6WR 
F_AR32WR 
F_ARS2W 
F_PATCH 


00001 
00002 
00004 
00010 
00020 
00040 
00100 
00200 
00400 
01000 
02000 


/* relocation entries stripped */ 
/* file is executable «/ 

/* line numbers stripped */ 

/* local symbols stripped */ 

/* minimal object file */ 

/* update file, ogen produced */ 
/* file is "pre-swabbed"” «/ 

/* 16 bit DEC host */ 

/*« 32 bit DEC host «/ 

/* non-DEC host */ 

f* "patch" list in opt hdr */ 
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file system — format of system volume 


SYNOPSIS 


#include <sys/filsys.h> 
#include <sys/types.h> 
#include <sys/param.h> 


DESCRIPTION 


Every file system storage volume has a common format for certain 
Every such volume is divided into a certain 
number of 512-byte long sectors. Sector 0 is unused and is avail- 
able to contain a bootstrap program or other information. 


vital information. 


Sector 1 is the super-block . The format of a super-block is: 


/* 


*« Structure of the super-block 


a / 

struct _filsys 

{ 
ushort 
daddr _t 
short 
daddr_t 
short 
ino_t 
char 
char 
char 
char 
time_t 
short 
daddr_t 
ino_t 
char 
char 
long 


long 


long 
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s_isize; 

s_fsize; 

s_nfree; 
s_free[NICFREE]; 
S_ninode; 
s_inode[NICINOD]; 
S_ flock; 

s_ilock; 

s_fmod:; 

s_ronly; 

s_time; 
s_dinfo[4]; 
s_tfree; 
s_tinode; 
s_fname[6]; 
s_fpack[6]; 
s_fill[13]; 


S_magic; 


S_type; 


/* size in blocks of t-list */ 

/* size in blocks of entire volume «. 
/* number of addresses in s_free =, 
/* free block list «: 

/* number of i-nodes in s_inode * 
/* free i-node list « 

/* lock during free list manipulation *’ 
/* lock during i-list manipulation *: 
/* super block modified flag */ 

/* mounted read-only flag */ 

/* last super block update *: 

/* device information */ 

/* total free blocks*/ 

/* total free i-nodes */ 

/* file system name */ 

/* file system pack name */ 

/* ADJUST to make sizeof filsys 

be 512 */ 

/* magic number to denote new 
file system */ 

/* type of new file system */ 
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#define FSMAGIC Oxfd187e20 /* § Magic number */ 


#define Fsib 1 /* 512 byte block */ 
#define Fs2b 2 i* 1024 byte block +/ — 


S_type indicates the file system type. Currently, one type of file 
system is supported: the 1024-byte oriented. S_magic is used to 
distinguish the original 512-byte oriented file systems from the 
newer file systems. If this field is not equal to the magic number, 
FSMAGIC , the type is assumed to be Fs7b , otherwise the s_type 
field is used. In the following description, a block is then determined 
by the type. A block is 1024 bytes or two sectors. The operating 
system takes care of all conversions from logical Been numbers to 
physical sector numbers. 


S_isize is the address of the first data block after the i-list; the i-list 
starts just after the super-block, namely in block 2; thus the i-list is 
s_isize—2 blocks long. S_fsize is the first block not potentially avail- 
able for allocation to a file. These numbers are used by the system 
to check for bad block numbers; if an “impossible” block number is 
allocated from the free list or is freed, a diagnostic is written on the 
on-line console. Moreover, the free array is cleared, so as to 
prevent further allocation from a presumably corrupted free list. 


The free list for each volume is maintained as follows. The s_free — ers 
array contains, in s_free [7], ..., s_free [ s_nfree —1], up to 49 ~ 


numbers of free blocks. S_free [0] is the block number of the head 
of a chain of blocks constituting the free list. The first long in each 
free-chain block is the number (up to 50) of free-block numbers 
listed in the next 50 longs of this chain member. The first of these 
50 blocks is the link to the next member of the chain. To allocate a 
block: decrement s_nfree , and the new block is s_free [ s_nfree |. If 
the new block number is 0, there are no blocks left, so give an error. 
If s_nfree became 0, read in the block named by the new block 
number, replace s_nfree by its first word, and copy the block 
numbers in the next 50 longs into the s_free array. To free a block, 
check if s_nfree is 50; if so, copy s_nfree and the s_free array into 
it, write it out, and set s_nfree to 0. In any event set s_free [ 
s_ntree ] to the freed block’s number and increment s_nfree . 


S_tfree is the total free blocks available in the file system. 


S_ninode is the number of free i-numbers in the s_inode array. To 
allocate an i-node: if s_ninode is greater than 0, decrement it and 
return s_inode [ s_ninode |]. If it was O, read the i-list and place the 
numbers of all free i-nodes (up to 100) into the s_inode array, then 
try again. To free an i-node, provided s_ninode is less than 100, 
place its number into s_inode [ s_ninode | and increment s_ninode . 
If s_ninode is already 100, do not bother to enter the freed i-node 
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into any table. This list of i-nodes is only to speed up the allocation 
process; the information as to whether the i-node is really free or not 
is maintained in the I-node itself. 


S_ftinode is the total free i-nodes available in the file system. 


S_flock and s_ilock are flags maintained in the core copy of the file 
system while it is mounted and their values on disk are immaterial. 
The value of s_fmod on disk is likewise immaterial; it is used as a 
flag to indicate that the super-block has changed and should be 
copied to the disk during the next periodic update of file system 
information. 


S_ronly is a read-only flag to indicate write-protection. 


S_ftime is the last time the super-block of the file system was 
changed, and is the number of seconds that have elapsed since 
00:00 Jan. 1, 1970 (GMT). During a reboot, the s_time of the 
super-block for the root file system is used to set the system's idea 
of the time. 


S_fname is the name of the file system and s_fpack is the name of 
the pack. . 


l-numbers begin at 1, and the storage for i-nodes begins in block 2. 
Also, i-nodes are 64 bytes long. I-node 1 is reserved for future use. 
l-node 2 is reserved for the root directory of the file system, but no 
other i-rnumber has a built-in meaning. Each i-node represents one 
file. For the format of an i-node and its flags, see inode (4). 


/usr/include/sys/filsys.h 
/usr/include/sys/stat.h 


SEE ALSO 
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inode(4). 
fsck(1M), fsdb(1M), mkfs(1M) in the Sys5 UNIX Administrator Refer- 
ence Manual. 
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NAME 


fspec — format specification in text files 


DESCRIPTION 
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It is sometimes convenient to maintain text files on the UNIX system 
with non-standard tabs, (i.e., tabs which are not set at every eighth 
column). Such files must generally be converted to a standard for- 
mat, frequently by replacing all tabs with the appropriate number of 
spaces, before they can be processed by UNIX system commands. 
A format specification occurring in the first line of a text file specifies 
how tabs are to be expanded in the remainder of the file. 


A format specification consists of a sequence of parameters 
separated by blanks and surrounded by the brackets <: and :>. 
Each parameter consists of a keyletter, possibly followed immedi- 
ately by a value. The following parameters are recognized: 


ttabs The t parameter specifies the tab settings for the file. 
The value of fabs must be one of the following: 


1. a list of column numbers separated by commas, 
indicating tabs set at the specified columns; 


2. a-— followed immediately by an integer rn , indicat- 
ing tabs at intervals of n columns; 


3. a — followed by the name of a “canned” tab _ 


specification. 


Standard tabs are specified by t-—8, or equivalently, 
t1,9,17,25, etc. The canned tabs which are recognized 
are defined by the tabs (1) command. 


ssize The s parameter specifies a maximum line size. The 


value of size must be an integer. Size checking is per- © 


formed after tabs have been expanded, but before the 
margin is prepended. 


mmargin The m parameter specifies a number of spaces to be 
prepended to each line. The value of margin must be 
an integer. 


d The d parameter takes no value. Its presence indicates 
that the line containing the format specification is to be 
deleted from the converted file. 


e The e parameter takes no value. Its presence indicates 
that the current format is to prevail only until another 
format specification is encountered in the file. 


Default values, which are assumed for parameters not supplied, are a 


t-8 and m0. If the s parameter is not specified, no size checking is 
performed. If the first line of a file does not contain a format specifi- 
cation, the above defaults are assumed for the entire file. The 
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following is an example of a line containing a format specification: 

* <:t5,10,15 s72:> * 
lf a format specification can be disguised as a comment, it is not 
necessary to code the d parameter. 


SEE ALSO : 
ed(1), newform(1), tabs(1) in the Sys5 UNIX User Reference 
Manual. 
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NAME 


gettydefs — speed and terminal settings used by getty 


DESCRIPTION 
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The /etc/gettydefs file contains information used by getty (1M) to 
set up the speed and terminal settings for a line. It supplies infor- 
mation on what the /fogin prompt should look like. It also supplies 
the speed to try next if the user indicates the current speed is not 
correct by typing a <break> character. 


Each entry in /etc/gettydefs has the following format: 
label# initial-flags # final-flags # login-prompt #next-label 


Each entry is followed by a blank line. The various fields can con- 
tain quoted characters of the form \b , \n, \c, etc., as well as \ 
nnn, where nnn is the octal value of the desired character. The 
various fields are: 


label This is the string against which getty tries to match its 
second argument. It is often the speed, such as 
1200, at which the terminal is supposed to run, but it 
need not be (see below). 


initial-flags | These flags are the initial joct/ (2) settings to which 


the terminal is to be set if a terminal type is not speci- 


fied to getty . The flags that getty understands are | 


the same as the ones listed in 
/usr/include/sys/termio.h (see termio (7)). Normally 
only the speed flag is required in the initial-flags . 
Getty automatically sets the terminal to raw input 
mode and takes care of most of the other flags. The 

_ initial-flag settings remain in effect until getty exe- 
cutes login (7). 


final-flags These flags take the same values as the initial-flags 
and are set just prior to getty executes /ogin . The 
speed flag is again required. The composite flag 
SANE takes care of most of the other flags that need 
to be set so that the processor and terminal are com- 
municating in a rational fashion. The other two com- 
monly specified final-flags are TAB3 , so that tabs are 
sent to the terminal as spaces, and HUPCL , so that 
the line is hung up on the final close. 


login-prompt This entire field is printed as the login-prompt. Unlike 
the above fields where white space is ignored (a 
space, tab or new-line), they are included in the 
login- prompt field. 
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FILES 


next-label If this entry does not specify the desired speed, indi- 
cated by the user typing a <break> character, then 
getty will search for the entry with next-labe/ as its 
label field and set up the terminal for those settings. 
Usually, a series of speeds are linked together in this 
fashion, into a closed set; For instance, 2400 linked 
to 1200, which in turn is linked to 300, which finally is 
linked to 2400. 


lf getty is called without a second argument, then the first entry of 
/etc/gettydefs is used, thus making the first entry of /etc/gettydefs 
the default entry. It is also used if getty can not find the specified 
label . If /etc/gettydefs itself is missing, there is one entry built into 
the command which will bring up a terminal at 300 baud. 


It is strongly recommended that after making or modifying 
/etc/gettydefs , it be run through getty with the check option to be 
sure there are no errors. 


/etc/gettydefs 


SEE ALSO 


ioctl(2). 

getty(1M), tty(7) in the Sys5 UNIX Administrator's Reference 
Manual. 

login(1) in the Sys5 UNIX User’s Reference Manual. 
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NAME 
gps — graphical primitive string, format of graphical files 


DESCRIPTION 
GPS is a format used to store graphical data. Several routines have 
been developed to edit and display GPS files on various devices. 
Also, higher level graphics programs such as plot (in stat(1G)) and 
vtoc (in toc(1G)) produce GPS format output files. 


A GPS is composed of five types of graphical data or primitives. 


GPS PRIMITIVES 

lines The fines primitive has a variable number of points from 
which zero or more connected line segments are pro- 
duced. The first point given produces a move to that 
location. (A move is a relocation of the graphic cursor 
without drawing.) Successive points produce line seg- 
ments from the previous point. Parameters are available 
to set color, weight, and style (see below). 


arc The arc primitive has a variable number of points to 
which a Curve is fit. The first point produces a move to 
that point. If only two points are included, a line connect- 
es, ing the points will result; if three points a circular arc 
( | through the points is drawn; and if more than three, lines 
connect the points. (In the future, a spline will be fit to 
the points if they number greater than three.) Parameters 

are available to set color, weight, and style. 


text The text primitive draws characters. It requires a single 
point which locates the center of the first character to be 
drawn. Parameters are color, font, textsize, and 
textangle. 


hardware The hardware primitive draws hardware characters or 
gives control commands to a hardware device. A single 
point locates the beginning location of the hardware 
string. 


comment A comment is an integer string that is included in a GPS 
file but causes nothing to be displayed. All GPS files 
begin with a comment of zero length. 


GPS PARAMETERS 
color Color is an integer value set for arc, lines, and text primi- 
tives. 


weight Weight is an integer value set for arc and lines primitives 
to indicate line thickness. The value 0 is narrow weight, 
1 is bold, and 2 is medium weight. 
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style Style is an integer value set for lines and arc primitives 


to give one of the five different line styles that can be / 
drawn on TEKTRONIX 4010 series storage tubes. They < 


are: 
Q solid 
1 dotted 
2 dot dashed 
3 dashed 
4 long dashed 
font An integer value set for text primitives to designate. the 


text font to be used in drawing a character string. 
(Currently font is expressed as a four-bit weight value 
followed by a four-bit sfy/e value.) 


textsize Jextsize is an integer value used in text primitives to 

| express the size of the characters to be drawn. Textsize 
represents the height of characters in absolute universe- 
units and is stored at one-fifth this value in the size- 
orientation (so) word (see below). 


textangle Jextangile is a signed integer value used in text primi- 
tives to express rotation of the character string around 


the beginning point. Textangle is expressed in degrees ~ 
from the positive x-axis and can be a positive or negative | 


value. It is stored in the size-orientation (so) word as a 
value 256/360 of it’s absolute value. 


ORGANIZATION 
GPS primitives are organized internally as follows: 
lines Cw points sw 
arc cw points sw 
text cw point sw so [string | 
hardware cw point [string | 
comment cw [string | 
cw Cw is the control word and begins all primitives. It con- 


sists of four bits that contain a primitive-type code and 
twelve bits that contain the word-count for that primitive. 


point(s) Point(s) is one or more pairs of integer coordinates. 
Text and hardware primitives only require a single point. 
Point(s ) are values within a Cartesian plane or universe 
having 64K (-32K to +32K) points on each axis. 
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SW Sw is the style-word and is used in lines, arc, and text 
primitives. For all three, eight bits contain co/or informa- 
tion. In arc and lines eight bits are divided as four bits 
weight and four bits style. In the text primitive eight bits 
of sw contain the font. 


so So is the size-orientation word used in text primitives. 
Eight bits contain text size and eight bits contain text 
rotation. 

string String is a null-terminated character string. If the string 


does not end on a word boundary, an additional null is 
added to the GPS file to insure word-boundary alignment. 


SEE ALSO 
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graphics(1G), stat(1G), toc(1G) in the Sys5 UNIX User Reference 
Manual. 
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NAME 
group — group file 
DESCRIPTION 
Group contains for each group the following information: 
group name 
encrypted password 
numerical group ID 
comma-separated list of all users allowed in the group 
This is an ASCII file. The fields are separated by colons; each group 
is separated from the next by a new-line. If the password field is 
null, no password is demanded. 
This file resides in directory /etc . Because of the encrypted pass- 
words, it can and does have general read permission and can be 
used, for example, to map numerical group ID's to names. | 
FILES 
/etc/group 
SEE ALSO 
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crypt(3C), passwd(4). 
newgrp(1), passwd(1) in the Sys5 UNIX User Reference Manual. 
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NAME 


inittab — script for the init process 


( DESCRIPTION 
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The inittab file supplies the script to init ’s role as a general process 
dispatcher. The process that constitutes the majority of init ’s pro- 
cess dispatching activities is the line process /etc/getty that initiates 
individual terminal lines. Other processes typically dispatched by init 
are daemons and the shell. 


The inittab file is composed of entries that are position dependent 
and have the following format: 


id:rstate:action:process 


Each entry is delimited by a newline, however, a backslash (\) 
preceding a newline indicates a continuation of the entry. Up to 512 
characters per entry are permitted. Comments may be inserted in 
the process field using the sh (1) convention for comments. Com- 
ments for lines that spawn getty s are displayed by the who (7) 
command. It is expected that they will contain some information 
about the line such as the location. There are no limits (other than 
maximum entry size) imposed on the number of entries within the 
inittab file. The entry fields are: 


id This is one or two characters used to uniquely identify an 
entry. 


rstate This defines the run-level in which this entry is to be pro- 
cessed. Run-levels effectively correspond to a configura- 
tion of processes in the system. That is, each process 
spawned by init is assigned a run-level or run-levels in 
which it is allowed to exist. The run-levels are 
represented by a number ranging from 0 through 6 . As an 
example, if the system Is in run-leve/ 1 , only those entries 
having a 1 in the rstate field will be processed. When init 
is requested to change run-levels, all processes which do 
not have an entry in the rstate field for the target run-level 
will be sent the warning signal (SIGTERM) and allowed a 
20-second grace period before being forcibly terminated 
by a kill signal (SIGKILL). The rstate field can define multi- 
ple run-levels for a process by selecting more than one 
run-level in any combination from 0-6. If no run-level is 
specified, then the process is assumed to be valid at all 
run-levels 0—6 . There are three other values,a, bandc, 
which can appear in the rstafe field, even though they are 
not true run-levels . Entries which have these characters 
in the rstate field are processed only when the felinit (see 
init (1M)) process requests them to be run (regardless of 
the current run-level of the system). They differ from run- 
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levels in that init can never enter run-level a, bore. 
Also, a request for the execution of any of these 


processes does not change the current run-leve/ . Further- . 


more, a process started by an a, b or c command is not 
killed when init changes levels. They are only killed if their 
line in /etc/inittab is marked off in the action field, their 
line is deleted entirely from /etc/inittab , or init goes into 
the SINGLE USER state. 


Key words in this field tell init how to treat the process 
specified in the process field. The actions recognized by 
init are as follows: 


respawn If the process does not exist then start the 
process, do not wait for its termination (con- 
tinue scanning the inittab file), and when it 
dies restart the process. If the process 
currently exists then do nothing and continue 
scanning the inittab file. 


wait Upon init ’s entering the run-level that 
matches the entry’s rstate , start the process 
and wait for its termination. All subsequent 
reads of the inittab file while init is in the 


same run-level will cause init to ignore this - 


entry. 


once Upon init ’s entering a run-level that matches 
the entry's rstate , start the process, do not 
wait for its termination. When it dies, do not 
restart the process. If upon entering a new 
run-level, where the process is still running 
from a previous run-level change, the pro- 
gram will not be restarted. 


boot The entry is to be processed only at init ’s 
boot-time read of the inittab file. Init is to start 
the process, not wait for its termination; and 
when it dies, not restart the process. In order 
for this instruction to be meaningful, the 
rstate should be the default or it must match 
init ‘s run-level at boot time. This action is 
useful for an initialization function following a 
hardware reboot of the system. 


bootwait The entry is to be processed only at init ’s 


boot-time read of the inittab file. Init is to. 


start the process, wait for its termination and, 
when it dies, not restart the process. 


Page 2 


-_ 


& 


INITTAB(4) 


Page 3 


powerfail 


powerwait 


off 


ondemand 


initdefault 


sysinit 
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Execute the process associated with this 
entry only when init receives a power fail sig- 
nal (SIGPWR see signal (2)). 


Execute the process associated with this 
entry only when init receives a power fail sig- 
nal (SIGPWR) and wait until it terminates 
before continuing any processing of inittab . 


If the process associated with this entry is 
currently running, send the warning signal 
(SIGTERM) and wait 20 seconds before forci- 
bly terminating the process via the kill signal 
(SIGKILL). If the process is nonexistent, 
ignore the entry. 


This instruction is really a synonym for the 
respawn action. It is functionally identical to 
respawn but is given a different keyword in 
order to divorce its association with run- 
levels. This is used only with the a, bore 
values described in the rstate field. 


An entry with this action is only scanned 
when init initially invoked. /nit uses this entry, 
if it exists, to determine which run-leve! to 
enter initially. It does this by taking the 
highest run-level specified in the rstate field 
and using that as its initial state. If the rstate 
field is empty, this is interpreted as 0123456 
and so init will enter run-leve! 6 . Also, the 
initdefault entry cannot specify that init start 
in the SINGLE USER state. Additionally, if init 
does not find an _ initdefault entry in 
/etc/inittab , then it will request an initial run- 
level from the user at reboot time. If you 
wish to use the "autoboot mode" you must 
modify any scripts requiring terminal input on 
bootup, such as the file /etc/bcheckrc. The 
desired actions must be coded to happen 
automatically. 


Entries of this type are executed before init 
tries to access the console. It is expected 
that this entry will be only used to initialize 
devices on which init might try to ask the 
run-level question. These entries are exe- 
cuted and waited for before continuing. 
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process This is a sh command to be executed. The entire pro- 
cess field is prefixed with exec and passed to a forked sh_~" 
as sh -c ‘exec command ’. For this reason, any legal 
sh syntax can appear in the process field. Comments 
can be inserted with the ; # comment syntax. 


FILES 
/etc/inittab 


SEE ALSO 
exec(2), open(2), signal(2). 
getty(1M), init(iM) in the "Sys5 UNIX Administrator Reference 
Manual" . 
sh(1), who(1) in the Sys5 UN/X User Reference Manual. 
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NAME 
inode — format of an i-node 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/ino.h> 


DESCRIPTION 
An i-node for a plain file or directory in a file system has the follow- 
ing structure defined by <sys/ino.h> . 


/* Inode structure as it appears on a disk block. */ 
struct dinode 


{ 
ushort di_mode; /* mode and type of file */ 
short — di_nlink; /* number of links to file =/ 
ushort di_uid; /* Owner's user id */ 
—ushort di_gid: /* Owner's group id */ 
off_t di_size; /* number of bytes in file */ 
char  di_addr[40]; /* disk block addresses */ 
time_t di_atime; /* time last accessed */ 
time_t di_mtime;  /* time last modified «/ | 
time_t di_ctime; __/* time of last file status change */ 
= ie 
( , 
: * the 40 address bytes: 


* 39 used; 13 addresses 
* Of 3 bytes each. 
x / 
For the meaning of the defined types off_t and time_t see types (5). 


FILES 
/usr/include/sys/ino.h 


SEE ALSO 
stat(2), fs(4), types(5). 
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NAME 
ioctl.syscon — system console configuration file — gers 


DESCRIPTION es a 
This file is referenced by /etc/init when changing from state to state. 
It contains ASCII representations of hexadecimal values to be used to 
set up proper terminal characteristics for the system console. 


The file has 15 fields separated by colons. The fields are input 
mode flags, output mode flags, hardware control mode flags, local 
control mode flags, eight control characters and three fields used for 
special terminal handling. 


The Plexus default for this file is: 
526:1805:4bf:2b:7f:1¢:23:40:4:0:0:0:0:0:0 
The values thus set up are: 


input mode IXON | ICRNL | ISTRIP | IGNPAR | BRKINT 
output mode OPOST | ONLCR | TAB3 

hardware control EXTB|CS8|CREAD | MUPCL 

local control ISIG | ICANON | ECHO | ECHOK 

interrupt DEL (7f) 

quit FS (28) 

erase # 

kill @ 
EOF EOT (4) is 
EOL NULL (0) | 

not used 0 

SWTCH 0 


The final three flags, used only by /etc/init, are also zero. 


SEE ALSO 
termio(7) 


NOTES | sae 
If you shut down your system from a terminal other than your sys- 
tem console, this file may be set up with values that do not work 
properly. If you find you are unable to re-enter multi-user state after 
such a shutdown, edit this file, altering its values to the Plexus 
default given above. 


Se ia 
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NAME 
issue — issue identification file 


DESCRIPTION 
The file /etc/issue contains the issue or project identification to be 
printed as a login prompt. This is an ASCII file which is read by pro- 
gram getty and then written to any terminal spawned or respawned 
from the lines file. 


FILES 
/etc/issue 


SEE ALSO 
login(1) in the Sys5 UNIX User Reference Manual. 
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NAME 


Idfcn — common object file access routines 


SYNOPSIS 


#include <stdio.h> 
#include <filehdr.h> 
#include <Idfcn.h> 


DESCRIPTION 
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The common object file access routines are a collection of functions 
for reading an object file that is in (common) object file form. 
Although the calling program must know the detailed structure of the 
parts of the object file that it processes, the routines effectively insu- 
late the calling program from knowledge of the overall structure of 
the object file. 


The interface between the calling program and the object file access 
routines is based on the defined type LDFILE , defined as struct 
Idfile , declared in the header file Idfen.h . The primary purpose of 
this structure is to provide uniform access to both simple object files 
and to object files that are members of an archive file. 

The function [dopen (3X) allocates and initializes the LDFILE struc- 
ture and returns a pointer to the structure to the calling program. 
The fields of the LDFILE structure may be accessed individually | 
through macros defined in Idfen.h and contain the following informa- 
tion: 

LDFILE *ldptr; 


TYPE(Idptr) The file magic number, used to distinguish between 
| archive members and simple object files. 


lOPTR(Idptr) The file pointer returned by fopen and used by the 
standard input/output functions. 


OFFSET(Idptr) The file address of the beginning of the object file; 
the offset is non-zero if the object file is a member 
of an archive file. 


HEADER(Idptr) The file header structure of the object file. 


The object file access functions themselves may be divided into four 
categories: 


(1) functions that open or close an object file 


Idopen (3X) and Idopen (3X) 
open a common object file 
Idclose (3X) and Idclose (3X) 
close a common object file 
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(2) functions that read header or symbol table information 


( | Idahread (3X) | 
= read the archive header of a member of an 
archive file 
Idfhread (3X) 
read the file header of a common object file 
Idshread (3X) and Idshread (3X) 
read a section header of a common object 
file 
Idtbread (3X) 
read a symbol table entry of a common 
object file 
Idgetname (3X) 
retrieve a symbol name from a symbol table 
entry or from the string table 


(3) functions that position an object file at (seek to) the 
start of the section, relocation, or line number information 
for a particular section. 


Idohseek (3X) 

seek to the optional file header of a com- 
oa mon object file 
( | Idsseek (3X) and Idsseek (3X) 

seek to a section of a common object file 

Idrseek (3X) and Idrseek (3X) 
seek to the relocation information for a sec- 
tion of a common object file 

Idiseek (3X) and Idiseek (3X) 
seek to the line number information for a 
section of a common object file 

Idtbseek (3X) 
seek to the symbol table of a common 
object file 


(4) the function /dtbindex (3X) which returns the index of a 
particular common object file symbol table entry. 


These are described in detail on their respective manual pages. 


All the functions except /dopen (3X), ldgetname (3X), Idopen (3X), 
and /dtbindex (3X) return either SUCCESS or FAILURE , both con- 
stants defined in Idfcn.h . Ldopen (3X) and Idopen (3X) both return 
pointers to an LDFILE structure. 


Additional access to an object file is provided through a set of mac- 
ros defined in Idfcn.h . These macros parallel the standard 
input/output file reading and manipulating functions, translating a 
reference of the LDFILE structure into a reference to its file descrip- 
tor field. 
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The following macros are provided: 


GETC(Idptr) as 
FGETC(Idptr) a 
GETW(\dptr) 


UNGETC(c, Idptr) 

FGETS(s, n, Idptr) 
FREAD((char *) ptr, sizeof (*ptr), nitems, Idptr) 
FSEEK(ldptr, offset, ptrname) 
FTELL(ldptr) 

REWIND(Idptr) 

FEOF (Idptr) 

FERROR(Idptr) 
FILENO(Idptr) 

SETBUF(Idptr, buf) — 
STROFFSET(Idptr) 


The STROFFSET macro calculates the address of the string table in 
a UNIX system release 5.0 object file. See the manual entries for 
the corresponding standard input/output library functions for details 
on the use of the rest of the macros. 


The program must be loaded with the object file access routine 
library libld.a . 


WARNING . Se 
The macro FSEEK defined in the header file Idfcn.h translates into a 

call to the standard input/output function fseek (3S). FSEEK should 

not be used to seek from the end of an archive file since the end of 

an archive file may not be the same as the end of one of its object 

file members! 


SEE ALSO 
fseek(3S), Idahread(3X), Idclose(3X), Ildgetname(3X), Idfhread(3Xx), 
Idiread(3X), Idlseek(3X), Idohseek(3X), Idopen(3X), Idrseek(3X), 
Idiseek(3X), Idshread(3X), Idtbindex(3X), Idtbread(3X), Idtbseek(3X). 
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linenum — line number entries in a common object file 


SYNOPSIS 


#include <linenum.h> 


DESCRIPTION 


Compilers based on pcc generate an entry in the object file for each 
C source line on which a breakpoint is possible (when invoked with 
the -—g option; see cc (7)). Users can then reference line numbers 
when using the appropriate software test system. The structure of 
these line number entries appears below. 


struct lineno 


{ 
union 
{ | 
long |_ symndx ; 
long |_padadr ; 
} |_adar ; 
unsigned short I|_Inno ; 
I 


Numbering starts with one for each function. The initial line number 
entry for a function has /_/Inno equal to zero, and the symbol table 
index of the function’s entry is in _symndx . Otherwise, /_/nno is 
non-zero, and /_padar is the physical address of the code for the 
referenced line. Thus the overall structure is the following: 


|_adadr [_Inno 
function symtab index 0 
physical address line 
physical address line 


function symtab index 0O 
physical address line 
physical address line 


SEE ALSO 


( 


a.out(4). 
cc(1) in the Sys5 UNIX User Reference Manual. 
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NAME 
mnttab — mounted file system table 
SYNOPSIS 
#include <mnttab.h> 
DESCRIPTION . 
Mnttab resides in directory /etc and contains a table of devices, 
mounted by the mount (1M) command, in the following structure as 
defined by <mnttab.h> : 
struct mnttab { 
char mt_dev[MNTPATH]; 
char mt_node[10]; 
char mt_filsys[MNTPATH]; 
short mt_ro_flg; 
time_t mt_time; 
fi 
Each entry is 70 bytes in length; the first 32 bytes are the null- 
padded name of the place where the special file is mounted; the 
next 32 bytes represent the null-padded root name of the mounted 
special file; the remaining 6 bytes contain the mounted special file 
's read/write permissions and the date on which it was mounted. 
The maximum number of entries in mnttab is based on the system 
parameter NMOUNT located in /usr/src/uts/cf/conf.c , which defines 
the number of allowable mounted special files. 
SEE ALSO 
mount(1M), setmnt(1M) in the Sys5 UNIX Administrator Reference 
Manual. 
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NAME — pes 
passwd — password file 


DESCRIPTION 
Passwd contains for each user the following information: 


login name 

encrypted password 

numerical user ID 

numerical group ID 

GCOS job number, box number, optional GCOS user ID 
initial working directory 

program to use as Shell 


This is an ASCII file. Each field within each user's entry is separated 
from the next by a colon. The GCOS field is used only when com- 
municating with that system, and in other installations can contain 
any desired information. Each user is separated from the next by a 
new-line. lf the password field is null, no password is demanded; if 
the Shell field is null, the Shell itself is used. 


This file resides in directory /etc . Because of the encrypted pass- 
words, it can and does have general read permission and can be 
used, for example, to map numerical user IDs tonames. | es 


The encrypted password consists of 13 characters chosen from a _ 
64-character alphabet (., /, 0-9 , A-Z, a-z ), except when the 
password is null, in which case the encrypted password is also null. 
Password aging is effected for a particular user if his encrypted 
password in the password file is followed by a comma and a non- 

null string of characters from the above alphabet. (Such a string 
must be introduced in the first instance by the super-user.) 


The first character of the age, M say, denotes the maximum 
number of weeks for which a password is valid. A user who 
attempts to login after his password has expired will be forced to 
supply a new one. The next character, m say, denotes the 
minimum period in weeks which must expire before the password 
may be changed. The remaining characters define the week 
(counted from the beginning of 1970) when the password was last 
changed. (A null string is equivalent to zero.) M and m have numer- 
ical values in the range 0-63 that correspond to the 64-character 
alphabet shown above (i.e., / = 1 week; z = 63 weeks). Ifm = M 
= 0 (derived from the string . or .. ) the user will be forced to 
change his password the next time he logs in (and the “age” will 
disappear from his entry in the password file). If m > M (signified, « 
e.g., by the string ./ ) only the super-user will be able to change the Ne 
password. 


om 
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‘FILES 
i /etc/passwd 


SEE ALSO 
a64l(3C), crypt(3C), getowent(3C), group(4). 
login(1), passwd(1) in the Sys5 UNIX User Reference Manual. 
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NAME 


plot — graphics interface 


DESCRIPTION i 
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Files of this format are produced by routines described in plot (3X) 
and are interpreted for various devices by commands described in 
tplot (1G). A graphics file is a stream of plotting instructions. Each 
instruction consists of an ASCII letter usually followed by bytes of 
binary information. The instructions are executed in order. A point 
is designated by four bytes representing the x and y values; each 
value is a signed integer. The last designated point in an 1, m, n, or 
p instruction becomes the “current point” for the next instruction. 


Each of the following descriptions begins with the name of the 
corresponding routine in plot (3X). 


m move: The next four bytes give a new current point. 


n cont: Draw a line from the current point to the point given by the 
next four bytes. See tplot (7G). 


Pp point: Plot the point given by the next four bytes. 


| line: Draw a line from the point given by the next four bytes to 
the point given by the following four bytes. 


t label: Place the following ASCII string so that its first character © 


falls on the current point. The string is terminated by a new-line. 
e erase: Start another frame of output. 


f linemod: Take the following string, up to a new-line, as the style 
for drawing further lines. The styles are “dotted”, “solid”, ‘long- 
dashed”, “shortdashed”, and “dotdashed”. Effective only for the 
—T4014 and —Tver options of tp/ot (1G) (TEKTRONIX 4014 termi- 
nal and Versatec plotter). 


S space: The next four bytes give the lower left corner of the plot- 
ting area; the following four give the upper right corner. The plot 
will be magnified or reduced to fit the device as closely as possi- 
ble. 


Space settings that exactly fill the plotting area with unity scaling 
appear below for devices supported by the filters of tp/ot (1G). The 
upper limit is just outside the plotting area. In every case the plot- 
ting area is taken to be square; points outside may be displayable 
on devices whose face is not square. 


DAS! 300 space(0, 0, 4096, 4096) 
DAS! 300s space(0, 0, 4096, 4096): 
DAS! 450 space(0, 0, 4096, 4096); 
) 
) 


TEKTRONIX 4014 = space(0, 0, 3120, 3120 
Versatec plotter space(0, 0, 2048, 2048 


$ 
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SEE ALSO 
aa plot(3X), gps(4), term(5). 
( graph(1G), tplot(1G) in the Sys5 UNIX User Reference Manual. 

WARNING 
The plotting library plot (3X) and the curses library curses (3X) both 
use the names erase() and move(). The curses versions are mac- 
ros. If you need both libraries, put the plot (3X) code in a different 
source file than the curses (3X) code, and/or #undef move() and 
erase() in the plot (3X) code. 


C 
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NAME 


Fe 


profile — setting up an environment at login time 


DESCRIPTION 


FILES 


lf your login directory contains a file named .profile , that file will be 
executed (via exec .profile ) before your session begins; -profile s 
are handy for setting exported environment variables and terminal 
modes. If the file /etc/profile exists, it will be executed for every 
user before the .profile . The following example is typical (except for 
the comments): 


# Make some environment variables global 
export MAIL PATH TERM 
# Set file creation mask 
umask 22 
# Tell me when new mail comes in 
MAIL =/usr/mail/myname 3 
# Add my /bin directory to the shell search sequence 
PATH=$PATH:$HOME, bin 
# Set terminal type 
echo “terminal: \c" 
read TERM 
case $TERM in 
300) stty cr2 nlO tabs; tabs;; 
300s) stty cr2 nlO tabs; tabs;; 
450) stty cr2 nlO tabs; tabs;; 
hp) stty crO nl0 tabs; tabs;; 
745 |735) _ stty cr1 nit -tabs; TERM=745;; 
43) stty cri nl0 -tabs;; 
4014 |tek) stty crO nl0 -tabs ff1; TERM=4014; echo ‘'\33;";; 
** ) echo "$STERM unknown":; 
esac 


$SHOME/.profile 
/etc/profile 


SEE ALSO 


; 
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environ(5), term(5). 
env(1), login(1), mail(1), sh(1), stty(1), su(1) in the Sys5 UNIX User 
Reference Manual. 
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NAME 2 
reloc — relocation information for a common object file a 

SYNOPSIS i 
#include <reloc.h> 

DESCRIPTION 


Object files have one relocation entry for each relocatable refererce 
in the text or data. If relocation information is present, it will be in 
the following format. 


struct reloc 


{ 
long r_vaddr; _,* (virtual) address of reference «. 
long r_symndx : ;* index into symbol table «; 
short r_type ; * relocation type *, 

ee 

[* 

" All generics 

is reloc. already performed to symbol in the same section 

#define R_ABS 0 


“ 3B computer generic 

i 24-bit direct reference 

24-bit “relative” reference 

16-bit optimized “indirect” TV reference 
24-bit “indirect” TV reference 

32-bit “indirect” TV reference 


* 
*« 
* 


#define R_DIR24 04 
#define R_REL24 05 
#define R_OPT16 014 
#define R_IND24 015 
#define R_IND32 016 


[k 


* DEC Processors VAX 11/780 and VAX 11/750 


* 


*/ 


#define R_RELBYTE 017 aa 
#define R_-RELWORD 020 a 
#define R_RELLONG 021 — 
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#define R PCRBYTE 022 
#define R PCRWORD 023 
#define R PCRLONG 024 


As the link editor reads each input section and performs relocation, 
the relocation entries are read. They direct how references found 
within the input section are treated. 


R_ ABS 


R_DIR24 
R REL24 


R_ OPT16 


R_IND24 


R_IND32 


The reference is absolute, and no relocation is neces- 
sary. The entry will be ignored. 


A direct, 24-bit reference to a symbols virtual address. 


A “PC-relative’, 24-bit reference to a symbol’s virtual 
address. Relative references occur in_ instructions 
such as jumps and cails. The actual address used is 
obtained by adding a constant to the value of the pro- 
gram counter at the time the instruction is executed. 


An optimized, indirect, 16-bit reference through a 
transfer vector. The instruction contains the offset into 
the transfer vector table to the transfer vector where 
the actual address of the referenced word is stored. 


An indirect, 24-bit reference through a transfer vector. 
The instruction contains the virtual address of the 
transfer vector, where the actual address of the refer- 
enced word is stored. 


An indirect, 32-bit reference through a transfer vector. 
The instruction contains the virtual address of the 
transfer vector, where the actual address of the refer- 
enced word is stored. 


R_ RELBYTE A direct 8-bit reference to a symbol’s virtual address. 
R_RELWORD A direct 16-bit reference to a symbol’s virtual address. 
R_RELLONG A direct 32-bit reference to a symbol’s virtual address. 
R_PCRBYTE A “PC-relative”’, 8-bit reference to a symbol’s virtual 


R_ PCRWORD 


address. 


A “PC-relative”’, 16-bit reference to a symbols virtual 
address. 


R_PCRLONG A “PC-relative’, 32-bit reference to a symbol’s virtual 


address. 


On the VAX processors relocation of a symbol index of -1 indicates 
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that the relative difference between the current segment's start 
address and the program's load address is added to the relocatable” 
address. ae, 


Other relocation types will be defined as they are needed. 


Relocation entries are generated automatically by the assembler 
and automatically utilized by the link editor. A link editor option 
exists for removing the relocation entries from an object file. 


SEE ALSO 
a.out(4), syms(4). | 
Id(1), strip(1) in the Sys5 UNIX User Reference Manual. 
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NAME 


sccsfile — format of SCCS file 


DESCRIPTION 
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An SCCS file is an ASCII file. It consists of six logical parts: the 
checksum , the delta table (contains information about each delta), 
user names (contains login names and/or numerical group IDs of 
users who may add deltas), flags (contains definitions of internal 
keywords), comments (contains arbitrary descriptive information 
about the file), and the body (contains the actual text lines inter- 
mixed with control lines). 


Throughout an SCCS file there are lines which begin with the ASCII 
SOH (start of heading) character (octal 001). This character is 
hereafter referred to as fhe control character and will be 
represented graphically as «. Any line described below which is 
not depicted as beginning with the control character is prevented 
from beginning with the control character. 


Entries of the form DDDDD represent a five-digit string (a number 
between 00000 and 99999). 


Each logical part of an SCCS file is described in detail below. 


Checksum 
The checksum is the first line of an SCCS file. The form of 
the line is: 


(chDDDDD 


The value of the checksum is the sum of all characters, 
except those of the first line. The («ch provides a magic 
number of (octal) 064001. 


Delta table 
The delta table consists of a variable number of entries of 
the form: 
(¢§ DDDDD/DDDDD/DDDDD 
(ad <type> <SCCSID> yrimorda hr:mi: 
se <pgmr-> DDDDD DDDDD 
(<i DDDODD ... 
(«x DDDDD ... 
(¢g DDDDD ... 
(@m <MR number> 


(@e <comments> ... 
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«ae 


The first line (cs) contains the number of lines 
inserted, deleted, unchanged, respectively. The second line 
((ad) contains the type of the delta (currently, normal: D, 
and removed: R), the SCCS ID of the delta, the date and 
time of creation of the delta, the login name corresponding 
to the real user ID at the time the delta was created, and the 
serial numbers of the delta and its predecessor, respec- 
tively. 


The «i, @x, and (@g lines contain the serial numbers of 
deltas included, excluded, and ignored, respectively. These 
lines are optional. 


The «@m lines (optional) each contain one MR number asso- 
clated with the delta; the «ce lines contain comments asso- 
ciated with the delta. 


The je line ends the delta table entry. 


User names 


Flags 
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The list of login names andor numerical group IDs of users 
who may add deltas to the file, separated by new-lines. The 
lines containing these login names and/or numerical group 
IDs are surrounded by the bracketing lines @u and @U. An 
empty list allows anyone to make a delta. Any line starting 
with a ! prohibits the succeeding group or user from making 
deltas. : 


Keywords used internally (see admin (1) for more informa- 
tion on their use). Each flag line takes the form: 


«at <flag> <optional text> 


The following flags are defined: 
«@ft  <type of program> 
«fv  <program name> 
(@fi  <keyword string> 


@fm <module name> 


(at f <floor> 
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fc <ceiling> 

(afd  <default-sid> 

tn 

caf | 

of | <lock-releases > 

(¢4fq  <user defined> 

(tf Z <reserved for use in interfaces > 


The t flag defines the replacement for the %Y% identification 
keyword. The v flag controls prompting for MR numbers in 
addition to comments; if the optional text is present it 
defines an MR number validity checking program. The t flag 
controls the warningrerror aspect of the “No id keywords” 
message. When the i flag is not present, this message is 
only a warning; when the i flag is present, this message will 
cause a ‘fatal’ error (the file will not be gotten, or the delta 
will not be made). When the b flag is present the —b 
keyletter may be used on the get command to cause a 
branch in the delta tree. The m flag defines the first choice 
for the replacement text of the %M% identification keyword. 
The f flag defines the “floor” release; the release below 
which no deltas may be added. The c flag defines the ‘ceil- 
ing’ release; the release above which no deltas may be 
added. The d flag defines the default SID to be used when 
none is specified on a get commard. The n flag causes 
delta to insert a “null” delta (a delta that applies no 
changes) in those releases that are skipped when a delta is 
made in a new release (e.g., when delta 5.1 is made after 
delta 2.7, releases 3 and 4 are skipped). The absence of 
the n flag causes skipped releases to be completely empty. 
The j flag causes get to allow concurrent edits of the same 
base SID. The | flag defines a list of releases that are 
locked against editing (get (7) with the -e keyletter). The q 
flag defines the replacement for the %Q% identification key- 
word. The z flag is used in certain specialized interface pro- 
grams. . 


Comments 
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Arbitrary text is surrounded by the bracketing lines @t and 
(@T. The comments section typically will contain a descrip- 
tion of the file’s purpose. 
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Body pre 
The body consists of text lines and control lines. Text lines 
do not begin with the control character, control lines do. aa 
There are three kinds of control lines: insert , delete , and 
end , represented by: 
(at DDDDD 
(¢D DDODD 
(aE DDDOD 
respectively. The digit string is the serial number 
corresponding to the delta for the control line. 
SEE ALSO 
admin(1), delta(1), get(1), prs(1) in the Sys5 UNIX User Reference 
Manual. 
Source Code Control System User Guide in the Sys5 UNIX User 
Guide . 


May 22, 1985 Page 4 


SCNHDR(4) UNIX Sys5 SCNHDR(4) 


NAME 


SYNOPSIS 
#include <scnhdr.h> 


DESCRIPTION 


scnhdr — section header for a common object file 


Every common object file has a table of section headers to specify 
the layout of the data within the file. Each section within an object 
file has its own header. The C structure appears below. 


struct scnhdr 
{ 
char 
long 
long 
long 
long 
long 
long 
unsigned short 
unsigned short 
long 


( : 


s_name[SYMNMLEN]; /* section name */ 
s_paddr; /* physical address */ 
s_vaddr;  /* virtual address «/ 

S_size; /* section size */ 

s_scnptr; /* file ptr to raw data «/ 
s_relptr; /* file ptr to relocation «/ 
s_Innoptr; /* file ptr to Jine numbers «/ 
s_nreloc; /* # reloc entries */ 
s_ninno; /* # line number entries */ 
s_flags; /« flags */ 


File pointers are byte offsets into the file; they can be used as the 


offset in a call to fseek (3S). If a section is initialized, the file con- 
tains the actual bytes. An uninitialized section is somewhat dif- 
ferent. It has a size, symbols defined in it, and symbols that refer to 
it. But it can have no relocation entries, line numbers, or data. 
Consequently, an uninitialized section has no raw data in the object 
file, and the values for s_scnptr ", " s_relptr'", " s_Innoptr , s_nreloc 


" and" s_ninno are zero. 


SEE ALSO 
fseek(3S), a.out(4). 


Id(1) in the Sys5 UNIX User Reference Manual. 
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NAME 
syms — common object file symbol table format 


SYNOPSIS , Ree 
#include <syms.h> : | 


DESCRIPTION 
Common object files contain information to support symbolic 
software testing. Line number entries, linenum (4), and extensive 
symbolic information permit testing at the C source level. Every 
object file's symbol table is organized as shown below. 


File name 1. 
Function 1. 
Local symbols for function 1. 
Function 2. 
Local symbols for function 2. 


Static externs for file 1. 


File name 2. 
Function 1. 
Local symbols for function 1. 
Function 2. ee 
Local symbols for function 2. 


Static externs for file 2. 


Defined global symbols. 
Undefined global symbols. 


The entry for a symbol is a fixed-length structure. The members of 
the structure hold the name (null padded), its value, and other infor- 
mation. The C structure is given below. 


#define SYMNMLEN' 8 
#define FILNMLEN 14 


struct syment 


{ 
union /* all ways to sym name */ 
{ 
char _n_name[SYMNMLEN]; /* symbol name +/ 
struct 
{ a™ 
long _n_zeroes; /* == OL whenstrng tbl | 
long _h_offset; _/*« location of name in table */ 
} _n_n; 
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char * n_nptr[2]; /* allows overlaying */ 
aa on; 
( long n_value; /* value of symbol */ 

- short n_scnum; __/* section number */ 
unsigned short n_type; /* type and derived type «/ 
char n_sclass; /* storage class */ 
char n_numaux; /* number of aux entries «/ 

hi 

#define n_name _n._n_name 
#define n_zeroes _nN._N_n._n_zeroes 
#define n_offset _n._n_n._n_offset 
#define n_nptr _h._n_nptr[1] 


Meaningful values and explanations for them are given in both 
syms.h and Common Object File Format . Anyone who needs to 
interpret the entries should seek more information in these sources. 
Some symbols require more information than a single entry; they 
are followed by auxiliary entries that are the same size as a symbol 
entry. The format follows. 


union auxent 


_ \ 
( : struct 
long x_tagndx; 
union 
{ 
struct 
{ 
unsigned short x_Inno; 
unsigned short x_size; 
\x_Insz; 
long x_fsize; 
} x_misc; 
union 
{ 
struct 
{ 
long  x_Innoptr; 
long x_endndx; 
} x_fcn; 
struct 
— | unsigned short x_dimen[DIMNUM]; 
- } X_ary; 
} x_fcnary; 


unsigned short x_tvndx; 
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\ X_sym; 

struct | os. 
char x_fname[FILNMLEN]}; 

} x_file; | 

struct 

{ 


long x_scnlen; 

unsigned short x_nreloc; 

unsigned short x_nlinno; 
\ X_Scn; 


struct 


{ 
long x_tvfill; 


unsigned short x_tvlen; 
unsigned short x_tvran[2]; 
\ x_tv; 
ie 
Indexes of symbol table entries begin at zero . 


SEE ALSO 

a.out(4), linenum(4). 
CAVEATS 
To minimize the complexity of the compiler code generator, the 
compiler will define symbols declared as /ongs to be ints in the sym- 
bol table, as longs and ints are of the same size. . 
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NAME 


term — format of compiled term file. 


SYNOPSIS 


term 


DESCRIPTION 
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Compiled terminfo descriptions are placed under the directory 
/usr/lib/terminfo. In order to avoid a linear search of a huge UNIX 
system directory, a two-level scheme is used: 
/usr/lib/terminfo/c/name where name is the name of the terminal, 
and c is the first character of name . Thus, act4 can be found in the 
file /usr/lib/terminfo/a/act4. Synonyms for the same terminal are 
implemented by multiple links to the same compiled file. 


The format has been chosen so that it will be the same on all 
hardware. An 8 or more bit byte is assumed, but no assumptions 
about byte ordering or sign extension are made. 


The compiled file is created with the compile program, and read by 
the routine setupterm . Both of these pieces of software are part of 
curses (3X). The file is divided into six parts: the header, terminal 
names, boolean flags, numbers, strings, and string table. 


The header section begins the file. This section contains six short 
integers in the format described below. These integers are (1) the 
magic number (octal 0432); (2) the size, in bytes, of the names sec- 
tion; (3) the number of bytes in the boolean section; (4) the number 
of short integers in the numbers section, (5) the number of offsets 
(short integers) in the strings section; (6) the size, in bytes, of the 
string table. 


Short integers are stored in two 8-bit bytes. The first byte contains 
the least significant 8 bits of the value, and the second byte contains 
the most significant 8 bits. (Thus, the value represented is 
256*second+ first.) The value —1 is represented by 0377, 0377, 
other negative value are illegal. The —1 generally means that a 
capability is missing from this terminal. Note that this format 
corresponds to the hardware of the VAX and PDP-11. Machines 
where this does not correspond to the hardware read the integers 
as two bytes and compute the result. 


The terminal names section comes next. It contains the first line of 
the terminfo description, listing the various names for the terminal, 
separated by the { character. The section is terminated with an 
ASCII NUL character. 
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The boolean flags have one byte for each flag. This byte is either 0 
or 1 as the flag is present or absent. The capabilities are in the ~ 
same order as the file <term.h>. : 


a 


Se ot 
Between the boolean section and the number section, a null byte 

will be inserted, if necessary, to ensure that the number section 
begins on an even byte. All short integers are aligned on a short 
word boundary. 


The numbers section is similar to the flags section. Each capability 
takes up two bytes, and is stored as a short integer. If the value 
represented is —1, the capability is taken to be missing. 


The strings section is also similar. Each capability is stored as a 
short integer, in the format above. A value of —-1 means the capabil- 
ity is missing. Otherwise, the value is taken as an offset from the 
beginning of the string table. Special characters in “X or \c notation 
are stored in their interpreted form, not the printing representation. 
Padding information $<nn> and parameter information %x are 
stored intact in uninterpreted form. 


The final section is the string table. It contains all the values of 
string capabilities referenced in the string section. Each string is 
null terminated. 


Note that it is possible for setupferm to expect a different set of 
Capabilities than are actually present in the file. Either the database ~-- 
may have been updated since sefupterm has been recompiled 
(resulting in extra unrecognized entries in the file) or the program 
may have been recompiled more recently than the database was 
updated (resulting in missing entries). The routine setupterm must 

be prepared for both possibilities — this is why the numbers and 
sizes are included. Also, new capabilities must always be added at 

the end of the lists of boolean, number, and string capabilities. 


As an example, an octal dump of the description for the Microterm 
ACT 4 is included: 7 


microtermiact4imicroterm act iv, 
cr="M, cudi=‘J, ind=‘J, bel="°G, am, cub1="H, 
ed="_, el="", clear="L, cup="T%p1%c%p2%c, 
cols#80, lines#24, cuf1="X, cuu1="Z, home='], 


OOO 032 OO1 \O 025 \O \b \O 212 \O * \O 

m 1 c r 020 re) t  e r m | a c t 

4 | m sl Cc r o 040 t =) r m a 
ct 14 ov \O \O 001 \O \O 060 \O \O \O- 
\o \o \o \o \o \o \o \o \o \o \o \o \o ~~” 
100 \O \O P \O 377 377 030 \O 377 377 377 377 

377 377 377 377 120 377 377 377 377 \O \O O02 \O 
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377 377 377 377 004 \O 006 \O 140 \b \O 377 377 

 _ 377 377 \n \O 026 \O 030 \O 377 377 032 \O 160 

( 377 377 377 377 034 \O 377 377 O36 \O 377 377 377 
377 377 377 200 377 377 377 377 377 377 377 377 377 
377 377 377 377 #377 #377 #377 +* #520 377 377 377 377 
\O 377 377 377 377 #377 #377 #377 #377 «#377 «+377 «S40 377 
377 377 377 377 377 007 \O \r \O \f \O 036 \O 
037 \O 560 024 % Pp 1 % Cc % p 2 % 
c \O \n \O 035 \O 600 \b \O 030 \O 032 \O \n 
\O 


Some limitations: total compiled entries cannot exceed 4096 bytes. 
The name field cannot exceed 128 bytes. 


FILES 
/usr/lib/terminfo/*/* compiled terminal capability data base 


SEE ALSO 
curses(3X), terminfo(4). 
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NAME 
termcap — terminal capability data base _ 
. va 
SYNOPSIS . : 
/etc/termcap | a ee 
DESCRIPTION 


Termcap has been replaced by curses(3x) in Sys5. The information is 
included here for downward compatibility only. 


Termcap is a database describing terminals, used, e.g., by vi(1) and 
curses (3). Termcap describes terminals by listing a set of their capa- 
bilities, and by describing how operations are performed. Padding 
requirements and initialization sequences are included in termcap. 


Entries in termcap consist of a number of fields, separated by ‘:’. The 
first entry for each terminal gives the names that are known for the 
terminal, separated by ‘|’ characters. The first name is always 2 char- 
acters long and is used by older version 6 systems, which store the 
terminal type in a 16 bit word in a systemwide data base. The 
second name is the most common abbreviation for the terminal, and 
the last name should be a long name fully identifying the terminal. 
The second name should contain no blanks; the last name may con- 
tain blanks for readability. 


CAPABILITIES 
(P) padding may be specified 
(P*) padding may be based on the number of lines affected ee 
Name Type Pad? Description 
ae str = (P) End alternate character set 
al str (P*) Add new biank line 


am bool Terminal has automatic margins 

as str (P) Start alternate character set 

bc Str Backspace if not “H 

bs bool . Terminal can backspace with “H 

bt str (P) Back tab 

bw bool Backspace wraps from column 0 to last column 

CC Str Command character in prototype if terminal settable 


cd str (P*) Clear to end of display 
ce str  (P) Clear to end of line 
ch Str (P) Like cm but horizontal motion only, line stays same 


cl str (P*) Clear screen 
cm str (P) Cursor motion 
co num Number of columns in a line 


cr str (P*) Carriage return, (default “M) 
cs str (P) Change scrolling region (vt100), like cm 
CV str = (P) Like ch but vertical only. 


da bool Display may be retained above 

dB num Number of millisec of bs delay needed 

db bool Display may be retained below _ 
dC num Number of millisec of cr delay needed ie 
dc str (P*) Delete character Nee 
dF num Number of millisec of ff delay needed 

dl str (P*) Delete line 
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dm str Delete mode (enter) 
dN num Number of millisec of nl delay needed 
do str Down one line 
dT num Number of millisec of tab delay needed 
ed Str End delete mode 
ei Str End insert mode; give :ei=: if ic 
€0 str Can erase overstrikes with a blank 
ff str (P*) Hardcopy terminal page eject (default “L) 
he bool Hardcopy terminal 
hd str Half-line down (forward 1/2 linefeed) 
ho str Home cursor (if no cm) 
hu str Half-line up (reverse 1/2 linefeed) 
hz str Hazeltine; can’t print ~’s 
ic str —_ (P) Insert character 
if str Name of file containing is 
im bool Insert mode (enter); give :im=: if ic 
in bool Insert mode distinguishes nulls on display 
ip str (P*) Insert pad after character inserted 
is str Terminal initialization string 
kO-k9 str Sent by other function keys 0-9 
kb: str Sent by backspace key 
kd str Sent by terminal down arrow key 
ke str Out of keypad transmit mode 
kh str Sent by home key 

kl str Sent by terminal left arrow key 

co kn num Number of other keys 
ko Str Termcap entries for other non-function keys 
kr str Sent by terminal right arrow key 
ks str Put terminal in keypad transmit mode 
ku str Sent by terminal up arrow key 
0-19 str Labels on other function keys 
li num Number of lines on screen or page 
I Str Last line, first column (if no cm) 
ma str Arrow key map, used by vi version 2 only 
mi bool Safe to move while in insert mode 
ml Str Memory lock on above cursor. 
mu Str Memory unlock (turn off memory lock). 
nc bool No correctly working carriage return (DM2500,H2000) 
nd Str Non-destructive space (cursor right) 
nl str (P*) Newline character (default \n) 
ns bool Terminal is a CRT but doesn’t scroll. 
Os bool Terminal overstrikes 
pc str Pad character (rather than null) 
pt bool Has hardware tabs (may need to be set with is) 
se Str End stand out mode 
sf str (P) Scroll forwards 
sg num Number of blank chars left by so or se 
Xe) Str Begin stand out mode 
. sr str (P) Scroll reverse (backwards) 

ta str (P) Tab (other than “lI or with padding) 
tc Str Entry of similar terminal - must be last 
te Str String to end programs that use cm 
ti str String to begin programs that use cm 
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uC Str Underscore one char and move past it 

ue str End underscore mode a 
ug num Number of blank chars left by us or ue 
ul bool Terminal underlines even though it doesn’t overstrike—- 
up str Upline (cursor up) 

us Str Start underscore mode 

vb str Visible bell (may not move cursor) 

ve Str Sequence to end open/visual mode 

vs Str Sequence to start open/visual mode 

xb bool Beehive (f1=escape, f2=ctrl C) 

xn bool A newline is ignored after a wrap (Concept) 

xr bool Return acts like ce \r \n (Delta Data) 

xs. __—bool Standout not erased by writing over it (HP 2647) 

xt bool Tabs are destructive, magic so char (Teleray 1061) 


A Sample Entry 


The following entry, which describes the Concept-100, is among the 
more complex entries in the termcap file as of this writing. (This par- 
ticular concept entry is outdated, and is used as an example only.) 


c1|c100|concept100:is=\EU\Ef\E7\E5\E8\EINENH\EK\E\200\E0&\200:\ 
-al=3*\E°R:am:bs:cd=16*\E"C:ce=16\E’S:cl=2”°L:cm=\Ea%+ %+ :co#80:\ 
:>dc=16\E°A:dl=3*\E'B:ei=\E\200:e0:im=\E P:in:ip=1 6*:1i#24:mi:nd=\E=:\ 
:se=\Ed\Ee:so=\ED\EE:ta=8\t:ul:up=\E;:vo=\EK\EK:xn: 


Entries may continue onto multiple lines by giving a \ as the last _ 
character of a line, and empty fields may be included for readability ~ 
(here between the last field on a line and the first field on the next). 
Capabilities in termcap are of three types: (1) Boolean capabilities, 
which indicate that the terminal has some particular feature; (2) 
numeric capabilities giving the size of the terminal or the size of par- 
ticular delays; and (8) string capabilities, which give a sequence that 
can be used to perform particular terminal operations. 


Types of Capabilities 


All capabilities have two letter codes. For instance, the fact that the 
Concept has automatic margins (automatic return and linefeed at end 
of line) is indicated by the capability am. Hence the description of 
the Concept includes am. Numeric capabilities are followed by the 
character ‘#’ and then the value. Thus co, which indicates the 
number of columns the terminal has, is ‘80’ for the Concept. 


Finally, string valued capabilities, such as ce (clear to end of line 
sequence) are given by the two-character code, an ‘=’, and then a 
string ending at the next following ‘:’. A delay in milliseconds may 
appear after the ‘=’ in such a capability, and padding characters are 
supplied by the editor after the remainder of the string is sent to pro- 
vide this delay. The delay can be either a integer, e.g. ‘20’, or an 
integer followed by a ‘’, i.e. ‘3%’. A ‘*’ indicates that the padding 
required is proportional to the number of lines affected by the opera- ars 
tion, and the amount given is the per-affected-unit padding required. : 
When a ‘*’ is specified, it is sometimes useful to give a delay of the eae ’ 
form ‘3.5’ specify a delay per unit to tenths of milliseconds. 
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Some escape sequences are provided in the string valued capabilities 
for easy encoding of characters. A \E maps to an ESCAPE Character, “x 
maps to a control-x for any appropriate x, and the sequences \n \r \t 
\b \f give a newline, return, tab, backspace and formfeed. Finally, 
characters may be given as three octal digits after a \, and the char- 
acters ~ and \ may be given as V and \\. If you must place a: ina 
Capability it must be escaped in octal as \072. If you must place a 
null character in a string capability it must be encoded as \200. The 
routines that deal with termcap use C Strings, and strip the high bits 
of the output very late so that a \200 comes out as a \000 would. 


Preparing Descriptions 


We now outline how to prepare descriptions of terminals. The most 
effective way to prepare a terminal description is to imitate the 
description of a similar terminal in termcap and then build up a 
description gradually, using partial descriptions with ex to check that 
they are correct. Be aware that a very unusual terminal may expose 
deficiencies in the ability of the termcap file to describe it or bugs in 
ex. To easily test a new terminal description you can set the environ- 
ment variable TERMCAP to a pathname of a file containing the 
description you are working on and the editor will look there rather 
than in /etc/termcap. TERMCAP can also be set to the termcap entry 
itself to avoid reading the file when starting up the editor. (This only 
works on version 7 systems.) 


Basic capabilities 


The number of columns on each line for the terminal is given by the 
co numeric capability. If the terminal is a CRT, then the number of 
lines on the screen is given by the li capability. If the terminal wraps 
around to the beginning of the next line when it reaches the right 
margin, then it should have the am capability. If the terminal can 
clear its screen, then this is given by the cl string capability. If the ter- 
minal can backspace, then it should have the bs capability, unless a 
backspace is accomplished by a character other than *H (ugh) in 
which case you should give this character as the be string capability. 
If it overstrikes (rather than clearing a position when a character is 
Struck over) then it should have the os capability. 


A very important point here is that the local cursor motions encoded 
in termcap are undefined at the left and top edges of a CRT terminal. 
The editor will never attempt to backspace around the left edge, nor 
will it attempt to go up locally off the top. The editor assumes that 
feeding off the bottom of the screen will cause the screen to scroll 
up, and the am capability tells whether the cursor sticks at the right 
edge of the screen. If the terminal has switch selectable automatic 
margins, the termcap file usually assumes that this is on, i.e. am. 


These capabilities suffice to describe hardcopy and glass-tty termi- 
nals. Thus the model 33 teletype is described as 


t3|33|tty33:co#72:0s 
while the Lear Siegler ADM-3 is described as 
cll|adm3]3|Ilsi adm3:am:bs:cl="Z:li#24:co#80 
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Cursor addressing 


Cursor addressing in the terminal is described by a em string capa- ~~ 
bility, with printf(3s) like escapes %x in it. These substitute to 
encodings of the current line or column position, while other charac- “— ~ 
ters pass through unchanged. If the cm string is thought of as a 
function, then its arguments are the line and then the column to 
which motion is desired, and the % encodings have the following 
meanings: 


%d as in printf, O origin 

%2 like %2d 

%3 like %3d 

%, like %c 

%+x adds x to value, then %. 

%>xy if value > x adds y, no output. 

%or reverses order of line and column, no output 

%i increments line/column (for 1 origin) 

%% gives a single % 7 
%N exclusive or row and column with 0140 (DM2500) 
%B BCD (16*(x/10)) + (x%10), no output. 

%D Reverse coding (x-2*(x%16)), no output. (Delta Data). 


Consider the HP2645, which, to get to row 3 and column 12, needs 
to be sent \E&a12cO3Y padded for 6 milliseconds. Note that the 
order of the rows and columns is inverted here, and that the row and 
column are printed as two digits. Thus its cm capability is 
CM=6\ER%r%2C%2Y. The Microterm act-lv needs the current row” 
and column sent preceded by a “T, with the row and column simply: 
encoded in binary, cm="T%.%.. Terminals which use %. need to be 
able to backspace the cursor (bs or be), and to move the cursor up 
one line on the screen (up introduced below). This is necessary 
because it is not always safe to transmit \t, \n “D and \r, as the sys- 
tem may change or discard them. 


us 
A 


A final example is the LS! ADM-3a, which uses row and column offset 
by a blank character, thus cm=\E=%+ %+. 


Cursor motions 


If the terminal can move the cursor one position to the right, leaving 
the character at the current position unchanged, then this sequence 
should be given as nd (non-destructive space). If it can move the cur- 
sor up a line on the screen in the same column, this should be given 
as up. If the terminal has no cursor addressing capability, but can 
home the cursor (to very upper left corner of screen) then this can be 
given as ho; similarly a fast way of getting to the lower left hand 
corner can be given as Il; this may involve going up with up from the 
home position, but the editor will never do this itself (unless Il does) 
because it makes no assumption about the effect of moving up from 
the home position. 


Area clears a™. 


If the terminal can clear from the current position to the end of the. _ 
line, leaving the cursor where it is, this should be given as ce. lf the 
terminal can clear from the current position to the end of the display, 
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then this should be given as ed. The editor only uses ed from the 
first column of a line. | 


insert/delete line 


If the terminal can open a new blank line before the line where the 
cursor is, this should be given as al; this is done only from the first 
position of a line. The cursor must then appear on the newly blank 
line. If the terminal can delete the line which the cursor is on, then 
this should be given as dl; this is done only from the first position on 
the line to be deleted. If the terminal can scroll the screen back- 

' wards, then this can be given as sb, but just al suffices. If the termi- 
nal can retain display memory above then the da capability should be 
given; if display memory can be retained below then db should be 
given. These let the editor understand that deleting a line on the 
screen may bring non-blank lines up from below or that scrolling 
back with sb may bring down non-blank lines. 


Insert/delete character 


There are two basic kinds of intelligent terminals with respect to 
insert/delete character that can be described using termcap. The 
most common insert/delete character operations affect only the char- 
acters on the current line and shift characters off the end of the line 
rigidly. Other terminals, such as the Concept 100 and the Perkin 
Elmer Owl, make a distinction between typed and untyped blanks on 
- the screen, shifting upon an insert or delete only to an untyped blank 
aie on the screen which is either eliminated, or expanded to two untyped 
( blanks. You can find out which kind of terminal you have by clearing 
the screen and then typing text separated by cursor motions. Type 
abc def using local cursor motions (not spaces) between the abc 
and the def. Then position the cursor before the abc and put the ter- 
minal in insert mode. If typing characters causes the rest of the line 
to shift rigidly and characters to fall off the end, then your terminal 
does not distinguish between blanks and untyped positions. If the 
abc shifts over to the def which then move together around the end 
of the current line and onto the next as you insert, you have the 
second type of terminal, and should give the capability in, which 
Stands for insert null. If your terminal does something different and 
unusual then you may have to modify the editor to get it to use the 
insert mode your terminal defines. All terminals we have seen have an 
insert mode falling into one of these two classes. 


The editor can handle both terminals that have an insert mode, and 
terminals that send a simple sequence to open a blank position on 
the current line. Give as im the sequence to get into insert mode, or 
give it an empty value if your terminal uses a sequence to insert a 
blank position. Give as ei the sequence to leave insert mode (give 
this, with an empty value also if you gave im so). Now give as ic any 
sequence needed to be sent just before sending the character to be 
inserted. Most terminals with a true insert mode will not give ic, termi- 
nals which send a sequence to open a screen position should give it 
here. (Insert mode is preferable to the sequence to open a position on 
the screen if your terminal has both.) lf post insert padding is 
needed, give this aS a number of milliseconds in ip (a string option). 
Any other sequence which may need to be sent after an insert of a 
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single character may also be given in ip. 
It is occasionally necessary to move around while in insert mode to 


delete characters on the same line (e.g. if there is a tab after the: 
insertion position). If your terminal allows motion while in insert mode * 


you can give the capability mi to speed up inserting in this case. 
Omitting mi will affect only speed. Some _ terminals (notably 
Datamedia’s) must not have mi because of the way their insert mode 
works. 


Finally, you can specify delete mode by giving dm and ed to enter 
and exit delete mode, and de to delete a single character while in 
delete mode. 


Highlighting, underlining, and visible bells 


lf your terminal has sequences to enter and exit standout mode these 
can be given as so and se respectively. If there are several flavors of 
standout mode (such as inverse video, blinking, or underlining — half 
bright is not usually an acceptable standout mode unless the terminal 
is in inverse video mode constantly) the preferred mode is inverse 
video by itself. If the code to change into or out of standout mode 
leaves one or even two blank spaces on the screen, as the TVI 912 
and Teleray 1061 do, this is acceptable, and although it may confuse 
some programs slightly, it can’t be helped. 


Codes to begin underlining and end underlining can be given as us 
and ue respectively. If the terminal has a code to underline the 


~, 


current Character and move the cursor one space to the right, such ~~ 
as the Microterm Mime, this can be given as uc. (If the underline _ 


code does not move the cursor to the right, give the code followed by ~ 


a nondestructive space.) 


If the terminal has a way of flashing the screen to indicate an error 
quietly (a bell replacement) then this can be given as vb; it must not 
move the cursor. If the terminal should be placed in a different mode 
during open and visual modes of ex, this can be given as vs and ve, 
sent at the start and end of these modes respectively. These can be 
used to change, e.g., from a underline to a block cursor and back. 


If the terminal needs to be in a special mode when running a program 
that addresses the cursor, the codes to enter and exit this mode can 
be given as ti and te. This arises, for example, from terminals like 
the Concept with more than one page of memory. If the terminal has 
only memory relative cursor addressing and not screen relative cursor 
addressing, a one screen-sized window must be fixed into the termi- 
nal for cursor addressing to work properly. 


If your terminal correctly generates underlined characters (with no 
special codes needed) even though it does not overstrike, then you 
should give the capability ul. If overstrikes are erasable with a blank, 
then this should be indicated by giving eo. 


Keypad 


lf the terminal has a keypad that transmits codes when the keys are : 


pressed, this information can be given. Note that it is not possible to 
handle terminals where the keypad only works in local (this applies, 
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for example, to the unshifted HP 2621 keys). If the keypad can be set 
to transmit or not transmit, give these codes as ks and ke. Otherwise 
the keypad is assumed to always transmit. The codes sent by the left 
arrow, right arrow, up arrow, down arrow, and home keys can be 
given as kl, kr, ku, kd, and kh respectively. If there are function keys 
such as f0, f1, ..., f9, the codes they send can be given as kO, k1, ..., 
k9. If these keys have labels other than the default fO through f9, the 
labels can be given as 10, 11, ..., 19. If there are other keys that 
transmit the same code as the terminal expects for the corresponding 
function, such as clear screen, the termcap 2 letter codes can be 
given in the ko capability, for example, :ko=cl,ll,sf,sb:, which says 
that the terminal has clear, home down, scroll down, and scroll up 
keys that transmit the same thing as the cl, Il, sf, and sb entries. 


The ma entry is also used to indicate arrow keys on terminals which 
have single character arrow keys. It is obsolete but still in use in ver- 
sion 2 of vi, which must be run on some minicomputers due to 
memory limitations. This field is redundant with kl, kr, ku, kd, and kh. 
It consists of groups of two characters. In each group, the first char- 
acter is what an arrow key sends, the second character is the 
corresponding vi command. These commands are h for kl, j for kd, k 
for ku, | for kr, and H for kh. For example, the mime would be 
:ma="Kj°Zk*XI: indicating arrow keys left (H), down (K), up (2), and 
right (“X). (There is no home key on the mime.) 


Miscellaneous 


If the terminal requires other than a null (zero) character as a pad, 
then this can be given as pc. 


If tabs on the terminal require padding, or if the terminal uses a char- 
acter other than “I to tab, then this can be given as ta. 


Hazeltine terminals, which don’t allow “’ characters to be printed 
should indicate hz. Datamedia terminals, which echo carriage-return 
linefeed for carriage return and then ignore a following linefeed 
should indicate ne. Early Concept terminals, which ignore a linefeed 
immediately after an am wrap, should indicate xn. If an erase-eol is 
required to get rid of standout (instead of merely writing on top of it), 
xs should be given. Teleray terminals, where tabs turn all characters 
moved over to blanks, should indicate xt. Other specific terminal 
problems may be corrected by adding more capabilities of the form 
XX. 


Other capabilities include is, an initialization string for the terminal, 
and if, the name of a file containing long initialization strings. These 
strings are expected to properly clear and then set the tabs on the 
terminal, if the terminal has settable tabs. If both are given, is will be 
printed before if. This is useful where if is /usr/lib/tabset/std but is 
clears the tabs first. 


Similar Terminals 


If there are two very similar terminals, one can be defined as being 
just like the other with certain exceptions. The string capability te 
can be given with the name of the similar terminal. This capability 
must be /ast and the combined length of the two entries must not 
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FILES 
/etc/termcap file containing terminal descriptions 

SEE ALSO 
ex(1), curses(3x), termlib(3c), tset(1), vi(1), ul(1), more(1). 

NOTES 
The Plexus version of termcap is based on the one developed ait the 
University of California at Berkeley. 

BUGS 
Ex allows only 256 characters for string Capabilities, and the routines 
in termcap(3) do not check for overflow of this buffer. The total 
length of a single entry (excluding only escaped newlines) may not 
exceed 1024. 
The ma, vs, and ve entries are specific to the vi program. 
Not all programs support all entries. There are entries that are not ‘ 
supported by any program. 
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exceed 1024. Since termiib routines search the entry from left to right, 
and since the tc capability is replaced by the corresponding entry, 
the capabilities given at the left override the ones in the similar termi- 
nal. A capability can be canceled with xx@ where xx is the capabil- 
ity. For example, the entry 


hn| 2621nI:ks@:ke@:tc=2621: 


defines a 2621nI that does not have the ks or ke capabilities, and 
hence does not turn on the function key labels when in visual mode. 
This is useful for different modes for a terminal, or for different user 
preferences. 
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NAME 


( _ SYNOPSIS 


terminfo — terminal capability data base 


/usr/lib/terminfo/*/* 


DESCRIPTION 


Terminfo is a data base describing terminals, used, e.g., , by vi (1) 
and curses (3X). Terminals are described in terminfo by giving a set 
of capabilities which they have, and by describing how operations 
are performed. Padding requirements and initialization sequences 
are included in terminfo. 


Entries in ferminfo consist of a number of ',’ separated fields. White 
space after each ‘, is ignored. The first entry for each terminal 
gives the names which are known for the terminal, separated by ‘ 
characters. The first name given is the most common abbreviation 
for the terminal, the last name given should be a long name fully 
identifying the terminal, and all others are understood as synonyms 
for the terminal name. All names but the last should be in lower 
case and contain no blanks; the last name may well contain upper 
case and blanks for readability. 


Terminal names (except for the last, verbose entry) should be 
chosen using the following conventions. The particular piece of 
hardware making up the terminal should have a root name chosen, 
thus “hp2621". This name should not contain hyphens, except that 
synonyms may be chosen that do not conflict with other names. 
Modes that the hardware can be in, or user preferences, should be 
indicated by appending a hyphen and an indicator of the mode. 
Thus, a vt100 in 132 column mode would be vt100-w. The following 
suffixes should be used where possible: 


Suffix Meaning Example 
-W Wide mode (more than 80 columns) — vt100-w 
-am With auto. margins (usually default) | vt100-am 
-nam Without automatic margins vt100-nam 
-n Number of lines on the screen aaa-60 
-Na No arrow keys (leave them in local) c100-na 
-p Number of pages of memory c100-4p 
-1V Reverse video c100-rv 
CAPABILITIES 
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The variable is the name by which the programmer (at the terminfo 
level) accesses the capability. The capname is the short name 
used in the text of the database, and is used by a person updating 
the database. The i.code is the two letter internal code used in the 
compiled database, and always corresponds to the old termcap 
capability name. 
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Capability names have no hard length limit, but an informal limit of 5 
characters has been adopted to keep them short and to allow the __ 
tabs in the source file caps to line up nicely. Whenever possible, |. 
names are chosen to be the same as or similar to the ANSI X3.64- “—~ 
1979 standard. Semantics are also intended to match those of the 


specification. 


(P) indicates that padding may be specified 


(G) indicates that the string is passed through toarm withparms 
as given (#1). 

(*) indicates that padding may be based on the number of lines 
affected 


Variable 
Booleans 
auto_left_margin, 


auto_right_margin, 
beehive _glitch, 
ceol_standout_glitch, 


eat_newline_glitch, 


erase_overstrike, 
generic_type, 


hard_copy, 
has_meta_key, 


has_status_line, 
insert_null_glitch, 
memory_above, 


memory _below, 


move_insert_mode, 
move_standout_mode, 
over_strike, 
status_line_esc_ok, 
teleray_glitch, 


tilde_glitch, 
transparent_underline, 
xon_xoff, 


May 30, 1986 


Cap- 
name 
bw 
am 
xsb 
xhp 


xenl 


msgr 


eslok 


xon 


(#.) indicates the jth parameter. 


l. 
Code 
bw 


am 
xb 


XS 


Xn 


€0 
gn 


Description 


cub1 wraps from column 0 to last 
column 

Terminal has automatic margins 
Beehive (f1=escape, f2=ctrl C) 
Standout not erased by overwriting 
(hp) a 
newline ignored after 80 cols 
(Concept) 

Can erase overstrikes with a blank 
Generic line type (e.g.,, dialup, 
Switch). 

Hardcopy terminal 

Has a meta key (shift, sets parity 

bit) 

Has extra "status line” 

Insert mode distinguishes nulls 
Display may be retained above the 
screen 

Display may be retained below the 
screen 

Safe to move while in insert mode 
Safe to move in standout modes 
Terminal overstrikes 

Escape can be used on the status line 
Tabs ruin, magic so char (Teleray 
1061) 

Hazeltine; can not print “'s eS 
underline character overstrikes Ke : 
Terminal uses xon/xoff handshaking 
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Numbers: 
columns, 
init_tabs, 

lines, 
lines_of_memory, 


magic_cookie_ glitch, 
padding baud _rate, 


virtual_terminal, 
width status _ line, 


Strings: 
back_tab, 

bell, 
carriage_return, 


change_scroll_region, 


clear_all_tabs, 
clear_screen, 

clr_eol. 

clr_eos, 
column_address, 
command character, 
cursor _address. 


cursor_down, 
cursor home, 
cursor_invisible, 
cursor_left, 


cursor mem_address. 


cursor_normal, 
cursor_right, 
cursor_to_ll, 
cursor_up, 
cursor_visible, 
delete_character, 
delete_line, 
dis_status_line, 
down_half_line, 


enter_alt_charset_mode, 


enter_blink_mode, 
enter_bold_mode, 
enter_ca_mode, 
enter_delete_mode, 
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cols co 
it it 
lines li 
Im Im 
xmc sg 
pb pb 
vt vt 
WSl WS 
cbt bt 
bel bl 
Ci cr 
csr (os) 
tbc ct 
clear cl 
el ce 
ed cd 
hpa ch 
cmdch CC 
cup cm 
cud1 do 
home ho 
Civis vi 
cub? le 
mrcup CM 
cnorm ve 
cuf1 nd 
il Il 
cuut up 
CVVIS vs 
dch‘1 dc 
di di 
dsl ds 
hd hd 
smacs as 
blink mb 
bold md 
smcup iti 
smdc dm 


TERMINFO(4) 


Number of columns in a line 

Tabs initially every # spaces 

Number of lines on screen or page 
Lines of memory if > lines. 0 means 
varies 

Number of blank chars left by smso or 
rmso 

Lowest baud where cr/nl padding is 
needed 

Virtual terminal number (UNIX system) 
No. columns in status line 


Back tab (P) 

Audible signal (bell) (P) 

Carriage return (P*) 

change to lines #1 through #2 (vt100) 
(PG) 

Clear all tab stops (P) 

Clear screen and home cursor (P*) 
Clear to end of line (P) 

Clear to end of display (P*) 

Set cursor column (PG) 

Term. settable cmd char in prototype 
Screen rel. cursor motion row #1 

col #2 (PG) 

Down one line 

Home cursor (if no cup) 

Make cursor invisible 

Move cursor left one space 

Memory relative cursor addressing 
Make cursor appear normal (undo vs‘vi) 
Non-destructive space (cursor right) 
Last line, first column (if no cup) 
Upline (cursor up) 

Make cursor very visible 

Delete character (P*) 

Delete line (P*) 

Disable status line 

Half-line down (forward 1/2 linefeed) 
Start alternate character set (P) 
Turn on blinking 

Turn on bold (extra bright) mode — 
String to begin programs that use cup 
Delete mode (enter) 
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enter_dim_mode, dim mh Turn on half-bright mode 
enter_insert_mode, smir im Insert mode (enter); —_—- 
enter_protected_mode, prot mp Turn on protected mode 
enter_reverse mode, rev mr Turn on reverse video mode =: — 
enter_secure_mode, invis mk Turn on blank mode (chars invisible) 
enter_standout_mode, smso so Begin stand out mode 
enter_underline_mode, smul us Start underscore mode 
erase_chars ech ec Erase #1 characters (PG) 
exit_alt_charset_mode, rmacs ae End alternate character set (P) 
exit_attribute_mode, sgrO me Turn off all attributes 
exit_ca_mode, rmcup te String to end programs that use cup 
exit_delete_mode, rmdc ed End delete mode 
exit_insert_mode, rmir él End insert mode 
exit_standout_mode, rmso se End stand out mode 
exit_underline_mode, rmul ue End underscore mode 
flash_screen, flash vb Visible bell (may not move cursor) 
form_feed, ff ff Hardcopy terminal page eject (P*) 
from_status_line, fsl fs Return from status line 
init_1 string, | ist if Terminal initialization string 
init_2string, is2 i2 Terminal initialization string 
init_Sstring, is3 iS Terminal initialization string 
init_file, if if Name of file containing is 
insert_character, | ich1 ic Insert character (P) : 
insert_line, il al Add new blank line (P*) - 
insert_padding, ip ip Insert pad after character inserted _ 

(p") | 
key_backspace, kbs kb Sent by backspace key 
key_catab, ktbc ka Sent by clear-all-tabs key 
key_clear, kclr kC Sent by clear screen or erase key 
key_ctab, | kctab kt Sent by clear-tab key 
key_dc. kdch1 kD Sent by delete character key 
key_dl, kdl kL Sent by delete line key 
key_down, kcud1 kd Sent by terminal down arrow key 
key_eic, krmir kM Sent by rmir or smir in insert mode 
key_eol, kel kE Sent by clear-to-end-of-line key 
key_€os, ked kS Sent by clear-to-end-of-screen key 
key_f0, kfO kO Sent by function key f0 
key_f1. kf1 k1 Sent by function key f1 
key_f10, kf10 ka Sent by function key f10 
key_f2, kf2 k2 Sent by function key f2 
key_f3, kf3 k3 Sent by function key f3 
key_f4, kf4 k4 Sent by function key f4 
key_f5, kf5 ite) Sent by function key f5 2, 
key_{6, kf6 k6 Sent by function key f6 : 
key_{7, ki7 k7 Sent by function key f7 ‘as 
key_{8, kf8 k8 Sent by function key f8 
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key_f9, kf9 k9 Sent by function key f9 
key_home. khome kh Sent by home key 
key _ic, kich1 kl Sent by ins char/enter ins mode key 
key_il, kilt kA Sent by insert line 
key _left, kcub1 kl Sent by terminal left arrow key 
key_ll, kil kH Sent by home-down key 
key_npage, kno KN Sent by next-page key 
key_ppage, kpp kP Sent by previous-page key. 
key_right, kcuf1 kr Sent by terminal right arrow key 
key_sf, kind kF Sent by scroll-forward'down key 
key_sr, kri kR Sent by scroil-backward.up key 
key_stab, khts kT Sent by set-tab key 
key_up, kcuu1 ku Sent by terminal up arrow key 
keypad _local, rmkx ke Out of “keypad transmit” mode. 
keypad_xmit. smkx ks Put terminal in "keypad transmit” mode 
lab_f0, IfO lO Labels on function key f0 if not f0 
lab_ft, If I1 Labels on function key f1 if not f1 | 
lab _f10. If10 la Labels on function key f10 if not f10 
lab_f2. If2 I2 Labels on function key f2 if not f2 . 
lab f8., If3 I3 Labels on function key f8 if not f3 
ab_f4. If4 l4 Labels on function key f4 if not f4 
lab _f5. If5 I5 Labels on function key f5 if not f5 
aan lab f6, If6 I6 Labels on function key f6 if not f6 
( lab _f7. If7 17 Labels on function key f7 if not f7 
= lab 8. If8 Ig Labels on function key {8 if not {8 
lab _f9. Ifg I9 Labels on function key f9 if not f9 
meta_on, smm mm Turn on "meta mode” (8th bit) 
meta_off, rmm mo Turn off "meta mode’ 
newline, nel nw Newline (behaves like cr followed. 
, by If) 
pad_char, pad pc Pad character (rather than null) 
parm_dch, dch DC Delete #1 chars (PG’‘*) 
parm_delete_line, dl DL Delete #1 lines (PG’*) 
parm_down_cursor, cud DO Move cursor down #1 lines (PG*) 
_-parm_ich, ich IC Insert #1 blank chars (PG*) 
parm_index, indn SF Scroll forward #1 lines (PG) 
parm_insert_line, i AL Add #1 new blank lines (PG”*) 
parm_left_cursor, cub LE Move cursor left #1 spaces (PG) 
parm_right_cursor, cuf al Move cursor right #1 spaces (PG"*) 
parm_rindex, rin SR Scroll backward #1 lines (PG) 
parm_up_cursor, cuu UP Move cursor up #1 lines (PG*) 
pkey_key, pftkey pk Prog funct key #1 to type string #2 
: pkey_local, pfloc pl Prog funct key #1 to execute string #2 
( : pkey_xmit, pfx px Prog funct key #1 to xmit string #2 
= print_screen, mcO ps Print contents of the screen 
| ortr_off, mc4 of Turn off the printer 
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prtr_on, mcs po Turn on the printer 
repeat_char, rep rp Repeat char #1 #2 times. (PG*) 
reset_istring, rst rf Reset terminal completely to sane t 3. 
reset_2string, rs2 r2 Reset terminal completely to sane Mivues. 
reset_Sstring, rs3 r3 Reset terminal completely to sane modes. 
reset_file, rf rf Name of file containing reset string 
restore_cursor, rc rc Restore cursor to position of last sc 
row_address, vpa CV Vertical position absolute 

(set row) (PG) 
save_cursor, SC SC Save cursor position (P) 
scroll_forward, ind sf Scroll text up (P) 
scroll_reverse, ri sr Scroll text down (P) 
set_attributes, sor sa Define the video attributes (PGQ) 
set_tab, hts st Set a tab in all rows, current column 
set_window, wind wi Current window is lines #1-#2 

cols #3-#4 
tab, ht ta Tab to next 8 space hardware tab stop 
to_status_line, | tsl ts Go to status line, column #1 
underline _char, UC uC Underscore one char and move past it 
up_half_line, hu hu Half-line up (reverse 1/2 linefeed) 
init_prog, iprog iP Path name of program for init 
key_al, kat K1 Upper left of keypad 
key_a3, ka3 K3 Upper right of keypad - 
key_b2, kb2 K2 Center of keypad a 
key_cl, kc K4 Lower left of keypad 
key_c3, Kc3 K5 Lower right of keypad 
prtr_non, mc5p pO Turn on the printer for #1 bytes 


A Sample Entry 


The following entry, which describes the Concept—100, is among the 
more complex entries in the terminfo file as of this writing. 


concepti100 | c100{ concept |c104|c100-4p|concept 100, 
am, bel="G, blank=\EH, blink=\EC, clear="L$<2*>, cnorm=\Ew, 
cols#80, cr="M$<9>, cubi="H, cud1i="J, cufi=\E=, 
cup=\Ea%pi% %+%c%p2% B+%e, 
cuui=\E;, cvvis=\EW, db, dchi=\E"A$<16*>, dim=\EE, d11=\E"B$<3*«>, 
ed=\E°C$<16*>, el=\E"U$<16>, eo, flash=\Ek$<20>\EK, ht=\t$<8>, 
L11=\E°R$<3*>, in, ind="J, .ind="J$<9>, ip=$<16*>, 
is2=\EU\Ef \E7\ES5\E8\E1\ENH\EK\E\200\E0&\200\Eo\47\E, 
kbs="h, kcubi=\E>, kcecudi=\E<, kcufi=\E=, kcuui=\E;, 
kfi=\ES5, kf2=\E6, kf3=\E7, khome=\E?, 
lines#24, mir, pb#9600, prot=\EI, rep=\Er%pi4chp2% %+&c$< .2*>, 
rev=\ED, rmcup=\Ev $<6>\Ep\r\n, rmir=\E\200, rmkx=\Ex, 
rmso=\Ed\Ee, rmul=\Eg, rmul=\Eg, sgr0=\EN\200, 
smcup=\EU\Ev 8p\Ep\r, smir=\E°P, smkx=\EX, smso=\EE\ED, oe 
smul=\EG, tabs, ul, vt#8, xenl, 


a 
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Entries may continue onto multiple lines by placing white space at 
ie the beginning of each line except the first. Comments may be 
( included on lines beginning with “#". Capabilities in terminfo are of 
three types: Boolean capabilities which indicate that the terminal has 
some particular feature, numeric capabilities giving the size of the 
terminal or the size of particular delays, and string Capabilities, 
which give a sequence which can be used to perform particular ter- 
minal operations. 


Types of Capabilities 


All capabilities have names. For instance, the fact that the Concept 
has automatic margins (i.e., an automatic return and linefeed when 
the end of a line is reached) is indicated by the capability am. 
Hence the description of the Concept includes am. Numeric capa- 
bilities are followed by the character ‘#° and then the value. Thus 
cols, which indicates the number of columns the terminal has, gives 
the value ‘80’ for the Concept. 


Finally, string valued capabilities, such as el (clear to end of line 
sequence) are given by the two-character code, an ‘=’, and then a 
string ending at the next following ',. A delay in milliseconds may 
appear anywhere in such a capability, enclosed in $<..> brackets, 
as in el=\EK$<3>, and padding characters are supplied by tputs to 
provide this delay. The delay can be either a number, e.g., ‘20’, or 
a number followed by an **’, 1.e., 3". A” indicates that the padding 
required is proportional to the number of lines affected by the opera- 
tion, and the amount given is the per-affected-unit padding required. 
(In the case of insert character, the factor is still the number of /ines 
affected. This is always one unless the terminal has xenl and the 
software uses it.) When a ™’ is specified, it is sometimes useful to 
give a delay of the form ‘3.5’ to specify a delay per unit to tenths of 
milliseconds. (Only one decimal place is allowed.) 


A number of escape sequences are provided in the string valued 
capabilities for easy encoding of characters there. Both \E and \e 
map to an ESCAPE character, “x maps to a control-x for any 
appropriate x, and the sequences \n \I \r \t \b \f \s give a newline, 
linefeed, return, tab, backspace, formfeed, and space. Other 
escapes include \’ for *, \\ for \, \, for comma, \: for :, and \O for null. 
(\0 will produce \200, which does not terminate a string but behaves 
as a null character on most terminals.) Finally, characters may be 
given as three octal digits after a \. 


Sometimes individual capabilities must be commented out. To do 
this, put a period before the capability name. For example, see the 
second ind in the example above. 
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Preparing Descriptions 


We now outline how to prepare descriptions of terminals. The most < 
effective way to prepare a terminal description is by imitating the 
description of a similar terminal in terminfo and to. build up a descrip- 
tion gradually, using partial descriptions with vi to check that they 
are correct. Be aware that a very unusual terminal may expose 
deficiencies in the ability of the terminfo file to describe it or bugs in 
vi. To easily test a new terminal description you can set the environ- 
ment variable TERMINFO to a pathname of a directory containing 
the compiled description you are working on and programs will look 
there rather than in /usr/lib/terminfo . To get the padding for insert 
line right (if the terminal manufacturer did not document it) a severe 
test is to edit /etc/passwd at 9600 baud, delete 16 or so lines from 
the middle of the screen, then hit the ‘u’ key several times quickly. 
If the terminal messes up, more padding is usually needed. A simi- 
lar test can be used for insert character. 


Basic Capabilities 


The number of columns on each line for the terminal is given by the 
cols numeric capability. If the terminal is a CRT, then the number of 
lines on the screen is given by the lines capability. If the terminal 
wraps around to the beginning of the next line when it reaches the - 
right margin, then it should have the am capability. If the terminal | 
can clear its screen, leaving the cursor in the home position, then — 
this is given by the clear string capability. If the terminal overstrikes 
(rather than clearing a position when a character is struck over) then 
it should have the os capability. If the terminal is-a printing terminal, 
with no soft copy unit, give it both he and os . (oS applies to storage 
scope terminals, such as TEKTRONIX 4010 series, as well as hard 

~ copy and APL terminals.) If there is a code to move the cursor to 
the left edge of the current row, give this as cr . (Normally this will 
be carriage return, control M.) If there is a code to produce an audi- 
ble signal (bell, beep, etc) give this as bel . — 


“ 
\ 


lf there is a code to move the cursor one position to the left (such. 
as backspace) that capability should be given as cub1 ... Similarly, 
codes to move to the right, up, and down should be given as cuf1 , 
~ cuul , and cud1 . These local cursor motions should not alter the 
text they pass over, for example, you would not normally use 
‘cuf1= ' because the space would erase the character moved over. 


A very important point here is that the local cursor motions encoded 
in terminfo are undefined at the left and top edges of a CRT termi- 
nal. Programs should never attempt to backspace around the left 
edge, unless bw is given, and never attempt to go up locally off the ~ 
top. In order to scroll text up, a program will go to the bottom left \_ 
corner of the screen and send the ind (index) string. 
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To scroll text down, a program goes to the top left corner of the 
screen and sends the ri (reverse index) string. The strings ind and 
ri are undefined when not on their respective corners of the screen. 


Parameterized versions of the scrolling sequences are indn and rin 
which have the same semantics as ind and ri except that they take 
one parameter, and scroll that many lines. They are also undefined 
except at the appropriate edge of the screen. 


The am capability tells whether the cursor sticks at the right edge of 
the screen when text is output, but this does not necessarily apply 
to a cuf1 from the last column. The only local motion which is 
defined from the left edge is if bw is given, then a cub1 from the left 
edge will move to the right edge of the previous row. If bw is not 
given, the effect is undefined. This is useful for drawing a box 
around the edge of the screen, for example. If the terminal has 
switch selectable automatic margins, the terminfo file usually 
assumes that this is on; te., am. If the terminal has a command 
which moves to the first column of the next line, that command can 
be given as nel (newline). It does not matter if the command clears 
the remainder of the current line, so if the terminal has no cr and lf 
it may still be possible to craft a working nel out of one or both of 
them. 


These capabilities suffice to describe hardcopy and glass-tty termi- 
nals. Thus the model 33 teletype Is described as 


33 | tty33|tty | model 33 teletype, 
pel="G, cols#72, cr="M, cudi="J, hc, ind="J, os, 


while the Lear Siegler ADM-—3 is described as 


adm3 |3|1si adm3,. 
am, bel="G, clear="Z, cols#80, cr="M, cubi="H, cudi="J, 
ind="J, lines#24, 


Parameterized Strings 


Cursor addressing and other strings requiring parameters in the ter- 
minal are described by a parameterized string capability, with printf 

(3S) like escapes %x in it. For example, to address the cursor, the 
cup capability is given, using two parameters: the row and column 
to address to. (Rows and columns are numbered from zero and 
refer to the physical screen visible to the user, not to any unseen 
memory.) If the terminal has memory relative cursor addressing, 
that can be indicated by mrcup . 


The parameter mechanism uses a stack and special % codes to 
manipulate it. Typically a sequence will push one of the parameters 
onto the stack and then print it in some format. Often more com- 
plex operations are necessary. 
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The % encodings have the following meanings: 


%o%o 


outputs *%’ 


%d print pop() as in printf 
%2d print pop() like %2d 

%3d print pop() like %3d 
%02d 

%03d as in printf 

%C print pop() gives %c 

%S print pop() gives %s 
%p[1-9] push ith parm 

%P{[a-z] set variable [a-z] to pop() 
%g{a-Z] get variable [a-z] and push it 
%'C’ char constant c 

%{nn} integer constant nn 


TERMINFO(4) > 


St %- %" %/ YM 

arithmetic (%m is mod): push(pop() op pop()) 
bit operations: push(pop() op pop()) 

logical operations: push(pop() op pop()) 


So& Yol Yo” 
%= M> %B< 


%o! Yo unary operations push(op pop()) 
%i add 1 to first two parms (for ANSI terminals) 
%? expr %t thenpart %e elsepart %; | NY 


if-then-else, %e elsepart is optional. 
else-ifs are possible ala Algol 68: 
%? C, %tb, %eC, Yt b, %e Cy 
*tb, *Ec, %tb 4 we %; 

c, are conditions, b; are bodies. 


Binary operations are in postfix form with the operands in the usual 
order. That is, to get x-5 one would use "%gx%{5}%-". 


Consider the HP2645, which, to get to row 3 and column 12, needs 
to be sent \E&a12cO3Y padded for 6 milliseconds. Note that the 
order of the rows and columns is inverted here, and that the row 
and column are printed as two digits. Thus its cup capability is 
Cup = B\E&%pP2%2dc%p1%2dY. : 


The Microterm ACT-IV needs the current row and column sent pre- 
ceded by a “T, with the row and column simply encoded in binary, 

cup= "T%p1%c%p2%c. Terminals which use %c need to be able to 
backspace the cursor (cub1), and to move the cursor up one line on 

the screen (cuu1). This is necessary because it is not always safe 

to transmit \n “D and \r, as the system may change or discard ~ 
them. (The library routines dealing with terminfo set tty modes so. 
that tabs are never expanded, so \t is safe to send. This turns out 

to be essential for the Ann Arbor 4080.) 
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A final example is the LS! ADM-3a, which uses row and column 
offset by a blank character, thus cup=\E=%p1% '%+%c%p2%’ 
‘%+%c. After sending \E=', this pushes the first parameter, 
pushes the ASCII value for a space (32), adds them (pushing the 
sum on the stack in place of the two previous values) and outputs 
that value as a character. Then the same is done for the second 
parameter. More complex arithmetic is possible using the stack. 


If the terminal has row or column absolute cursor addressing, these 
can be given as single parameter capabilities hpa (horizontal posi- 
tion absolute) and vpa (vertical position absolute). Sometimes 
these are shorter than the more general two parameter sequence 
(as with the hp2645) and can be used in preference to cup . If there 
are parameterized local motions (e.g., move n spaces to the right) 
these can be given as cud , cub, cuf , and cuu with a single 
parameter indicating how many spaces to move. These are pri- 
marily useful if the terminal does not have cup , such as the TEK- 
TRONIX 4025. 


Cursor Motions 


If the terminal has a fast way to home the cursor (to very upper left 
corner of screen) then this can be given as home; similarly a fast 
way of getting to the lower left-hand corner can be given as Il; this 
may involve going up with cuul from the home position, but a pro- 
gram should never do this itself (unless Il does) because it can 
make no assumption about the effect of moving up from the home 
position. Note that the home position is the same as addressing to 
(0,0): to the top left corner of the screen, not of memory. (Thus, the 
\EH sequence on HP terminals cannot be used for home .) 


Area Clears 


lf the terminal can clear from the current position to the end of the 
line, leaving the cursor where it is, this should be given as el. If the 
terminal can clear from the current position to the end of the display, 
then this should be given as ed. Ed is only defined from the first 
column of a line. (Thus, it can be simulated by a request to delete a 
large number of lines, if a true ed is not available.) 


Insert/delete line 


If the terminal can open a new biank line before the line where the 
cursor is, this should be given as il1; this is done only from the first 
position of a line. The cursor must then appear on the newly blank 
line. If the terminal can delete the line which the cursor is on, then 
this should be given as dl1; this is done only from the first position 
on the line to be deleted. Versions of il1 and dl1 which take a sin- 
gle parameter and insert or delete that many lines can be given as il 
and dl . If the terminal has a settable scrolling region (like the vt100) 
the command to set this can be described with the csr capability, 
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which takes two parameters: the top and bottom lines of the scrol- 
ling region. The cursor position is, alas, undefined after using this - 
command. It is possible to get the effect of insert or delete line. 
using this command — the se and re (save and restore cursor) com- — 
mands are also useful. Inserting lines at the top or bottom of the 
screen can also be done using ri or ind on many terminals without a 
true insert/delete line, and is often faster even on terminals with 
those features. 


If the terminal has the ability to define a window as part of memory, 
which all commands affect, it should be given as the parameterized 
string wind . The four parameters are the starting and ending lines 
in memory and the starting and ending columns: in emo, in that 
order. 


lf the terminal can retain display memory above, then the da capa- 
bility should be given; if display memory can be retained below, then 
db should be given. These indicate that deleting a line or scrolling 
may bring non-blank lines up from below or ne ela: back with 
ri may bring down non-biank lines. 


insert/Delete Character 


There are two basic kinds of intelligent terminals with respect to 


insert/delete character which can be described using terminfo. The ~~ 


most common insert/delete character operations affect only the | 
characters on the current line and shift characters off the end of the ~ 
line rigidly. Other terminals, such as the Concept 100 and the Per- 
kin Elmer Owl, make a distinction between typed and untyped 
blanks on the screen, shifting upon an insert or delete only to an 
untyped blank on the screen which is either eliminated, or expanded 
to two untyped blanks. You can determine the kind of terminal you 
have by clearing the screen and then typing text separated by cur- 
sor motions. Type abc def using local cursor motions (not 
spaces) between the abc and the def. Then position the cursor 
before the abc and put the terminal in insert mode. If typing charac- 
ters causes the rest of the line to shift rigidly and characters to fall 
off the end, then your terminal does not distinguish between blanks 
and untyped positions. If the abc shifts over to the def which then 
move together around the end of the current line and onto the next 
as you insert, you have the second type of terminal, and should give 
the capability in, which stands for insert null. While these are two 
logically separate attributes (one line vs. multiline insert mode, and 
special treatment of untyped spaces) we have seen no terminals 
whose insert mode cannot be described with the single attribute. 


Terminfo can describe both terminals which have an insert mode, ‘ 
and terminals which send a simple sequence to open a blank posi- < 
tion on the current line. Give as smir the sequence to get into 
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insert mode. Give as rmir the sequence to leave insert mode. Now 
give as ich1 any sequence needed to be sent just before sending 
the character to be inserted. Most terminals with a true insert mode 
will not give ich1; terminals which send a sequence to open a 
screen position should give it here. (If your terminal has both, insert 
mode is usually preferable to ich1.. Do not give both unless the ter- 
minal actually requires both to be used in combination.) If post insert 
padding is needed, give this as a number of milliseconds in ip (a 
string option). Any other sequence which may need to be sent after 
an insert of a single character may also be given in ip. If your ter- 
minal needs both to be placed into an ‘insert mode’ and a special 
code to precede each inserted character, then both smir / rmir and 
ich1 can be given, and both will be used. The ich capability, with 
one parameter, n. will repeat the effects of ich1 n times. 


It is occasionally necessary to move around while in insert mode to 
delete characters on the same line (e.g., if there is a tab after the 
insertion position). If your terminal allows motion while in insert 
mode you can give the capability mir to speed up inserting in this 
case. Omitting mir will affect only speed. Some terminals (notably 
Datamedia's) must not have mir because of the way their insert 
mode works. 


Finally, you can specify dch1 to delete a single character, dch with 
one parameter, n , to delete n characters, and delete mode by giv- 
ing smdc and rmdc to enter and exit delete mode (any mode the 
terminal needs to be placed in for dch1 to work). 


A command to erase n characters (equivalent to outputting n blanks 
without moving the cursor) can be given as ech with one parameter. 


Highlighting, Underlining, and Visible Bells 


lf your terminal has one or more kinds of display attributes, these 
can be represented in a number of different ways. You should 
choose one display form as standout mode, representing a good, 
high contrast, easy-on-the-eyes, format for highlighting error mes- 
sages and other attention getters. (lf you have a choice, reverse 
video plus half-bright is good, or reverse video alone.) The 
sequences to enter and exit standout mode are given as smso and 
rmso, respectively. If the code to change into or out of standout 
mode leaves one or even two blank spaces on the screen, as the 
TVI 912 and Teleray 1061 do, then xmc should be given to tell how 
many spaces are left. 


Codes to begin underlining and end underlining can be given as 
smul and rmul respectively. If the terminal has a code to underline 
the current character and move the cursor one space to the right, 
such as the Microterm Mime, this can be given as uc. © 
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Other capabilities to enter various highlighting modes include blink 
(blinking) bold (bold or extra bright) dim (dim or half-bright) invis 


a NN 
re 


(blanking or invisible text) prot (protected) rev (reverse video) sgrO | 


(turn off a/f attribute modes) smacs (enter alternate character set 
mode) and rmacs (exit alternate character set mode). Turning on 
any of these modes singly may or may not turn off other modes. 


If there is a sequence to set arbitrary combinations of modes, this 
should be given as sgr (set attributes), taking 9 parameters. Each 
parameter is either 0 or 1, as the corresponding attribute is on or 
off. The 9 parameters are, in order: standout, underline, reverse, 
blink, dim, bold, blank, protect, alternate character set. Not all 
modes need be supported by sgr , only those for which correspond- 
ing separate attribute commands exist. 


Terminals with the “magic cookie” glitch (xmc) deposit special 
“cookies” when they receive mode-setting sequences, which affect 
the display algorithm rather than having extra bits for each charac- 
ter. Some terminals, such as the HP 2621, automatically leave 
standout mode when they move to a new line or the cursor is 
addressed. Programs using standout mode should exit standout 
mode before moving the cursor or sending a newline, unless the 


msgr capability, asserting that it is safe to move in standout mode, 


is present. 


If the terminal has a way of flashing the screen to indicate an error 


quietly (a bell replacement) then this can be given as flash; it must 
not move the cursor. 


lf the cursor needs to be made more visible than normal when it is 
not on the bottom line (to make, for example, a non-blinking under- 
line into an easier to find block or blinking underline) give this 
sequence as cvvis . If there is a way to make the cursor completely 
invisible, give that as civis . The capability cnorm should be given 
which undoes the effects of both of these modes. 


If the terminal needs to be in a special mode when running a pro- 
gram that uses these capabilities, the codes to enter and exit this 
mode can be given as smcup and rmcup. This arises, for exam- 
ple, from terminals like the Concept with more than one page of 
memory. If the terminal has only memory relative cursor addressing 
and not screen relative cursor addressing, a one screen-sized win- 
dow must be fixed into the terminal for cursor addressing to work 
properly. This is also used for the TEKTRONIX 4025, where smcup 
sets the command character to be the one used by terminfo. 


If your terminal correctly generates underlined characters (with no 
special codes needed) even though it does not overstrike, then you 
should give the capability ul. If overstrikes are erasable with a 
blank, then this should be indicated by giving eo. 
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Keypad 


If the terminal has a keypad that transmits codes when the keys are 
pressed, this information can be given. Note that it is not possible to 
handle terminals where the keypad only works in local (this applies, 
for example, to the unshifted HP 2621 keys). If the keypad can be 
set to transmit or not transmit, give these codes as smkx and rmkx. 
Otherwise the keypad is assumed to always transmit. The codes 
sent by the left arrow, right arrow, up arrow, down arrow, and home 
keys can be given as kcub1, kcuf1, kcuu1, kcud1, and khome 
respectively. If there are function keys such as f0, f1, ..., f10, the 
codes they send can be given as kfO, kf1, ..., kf10. If these keys 
have labels other than the default fO through f10, the labels can be 
given as If0, If1, ..., If10. The codes transmitted by certain other 
special keys can be given: kil (home down), kbs (backspace), ktbc 
(clear all tabs), kctab (clear the tab stop in this column), kelr (clear 
screen or erase key), kdch1 (delete character), kdl1 (delete line), 
krmir (exit insert mode), kel (clear to end of line), ked (clear to end 
of screen), kich1 (insert character or enter insert mode), kil1 (insert 
line), kKnp (next page), kpp (previous page), kind (scroll 
forward/down), kri (scroll backward/up), khts (set a tab stop in this 
column). In addition, if the keypad has a 3 by 3 array of keys 
including the four arrow keys, the other five keys can be given as 
kal , ka3 , kb2 , kcl1 , and kc3 . These keys are useful when the 
effects of a 3 by 3 directional pad are needed. — 


Tabs and Initialization 


If the terminal has hardware tabs, the command to advance to the 
next tab stop can be given as ht (usually control |). A “backtab” 
command which moves leftward to the next tab stop can be given 
as cbt . By convention, if the teletype modes indicate that tabs are 
being expanded by the computer rather than being sent to the termi- 
nal, programs should not use ht or cbt even if they are present, 
since the user may not have the tab stops properly set. If the termi- 
nal has hardware tabs which are initially set every n spaces when 
the terminal is powered up, the numeric parameter it is given, show- 
ing the number of spaces the tabs are set to. This is normally used 
by the fsef command to determine whether to set the mode for 
hardware tab expansion, and whether to set the tab stops. If the 
terminal has tab stops that can be saved in nonvolatile memory, the 
terminfo description can assume that they are properly set. 


Other capabilities include is1 , is2 , and is3 , initialization strings for 
the terminal, iprog , the path name of a program to be run to initial- 
ize the terminal, and if, the name of a file containing long initializa- 
tion strings. These strings are expected to set the terminal into 
modes consistent with the rest of the terminfo description. They are 
normally sent to the terminal, by the tset program, each time the 


Page 15 May 30, 1986 


TERMINFO(4) UNIX Sys5 TERMINFO(4) 


user logs in. They will be printed in the following order: is1 ; is2 ; 
setting tabs using tbe and hts ; if ; running the program iprog ; and 


finally is3 . Most initialization is done with is2 . Special terminal \ 


modes can be set up without duplicating strings by putting the com- 
mon sequences in is2 and special cases in is1 and is3 . A pair of 
sequences that does a harder reset from a totally unknown state 
can be analogously given as rs1 , rs2 , rf , and rs3 , analogous to 
is2 and if . These strings are output by the reset program, which ts 
used when the terminal gets into a wedged state. Commands are 
normally placed in rs2 and rf only if they produce annoying effects 
on the screen and are not necessary when logging in. For example, 
the command to set the vt100 into 80-column mode would normally 
be part of is2 , but it causes an annoying glitch of the screen and is 
not normally needed since the terminal is usually already in 80 
column mode. 


lf there are commands to set and clear tab stops, they can be given 
as tbe (clear all tab stops) and hts (set a tab stop in the current 
column of every row). If a more complex sequence Is needed to set 
the tabs than can be described by this, the sequence can be placed 
in is2 or if . | 


Delays 


Certain capabilities control padding in the teletype driver. These are | 


primarily needed by hard copy terminals, and are used by the tset 
program to set teletype modes appropriately. Delays embedded in 
the capabilities cr , ind , cub1 , ff , and tab will cause the appropri- 
ate delay bits to be set in the teletype driver. If pb (padding baud 
rate) is given, these values can be ignored at baud rates below the 
value of pb. 


Miscellaneous 


If the terminal requires other than a null (zero) character as a pad, 
then this can be given as pad. Only the first character of the pad 
string is used. 


If the terminal has an extra “status line” that is not normally used by 
software, this fact can be indicated. If the status line is viewed as 
an extra line below the bottom line, into which one can cursor 
address normally (such as the Heathkit h19’s 25th line, or the 24th 
line of a vt100 which is set to a 23-line scrolling region), the capabil- 
ity hs should be given. Special strings to go to the beginning of the 
status line and to return from the status line can be given as tsl and 
fsl . (fsl must leave the cursor position in the same place it was 


before tsl . If necessary, the sc and rc strings can be included in tsi - 


and fsl to get this effect.) The parameter tsl takes one parameter, 
which is the column number of the status line the cursor is to be 
moved to. If escape sequences and other special commands, such 
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as tab, work while in the status line, the flag eslok can be given. A 
string which turns off the status line (or otherwise erases its con- 
tents) should be given as dsl . If the terminal has commands to 
save and restore the position of the cursor, give them as sc andrc. 
The status line is normally assumed to be the same width as the 
rest of the screen, e.g., cols . If the status line is a different width 
(possibly because the terminal does not allow an entire line to be 
loaded) the width, in columns, can be indicated with the numeric 
parameter wsl . 


If the terminal can move up or down half a line, this can be indicated 
with hu (half-line up) and hd (half-line down). This is primarily use- 
ful for superscripts and subscripts on hardcopy terminals. If a hard- 
copy terminal can eject to the next page (form feed), give this as ff 
(usually control L). 


lf there is a command to repeat a given character a given number of 
times (to save time transmitting a large number of identical charac- 
ters) this can be indicated with the parameterized string rep . The 
first parameter is the character to be repeated and the second is the 
number of times to repeat it. Thus, tparm(repeat_char, ’x’, 10) is the 
Same aS 'XXXXXXXXXX. 


TRONIX 4025, this can be indicated with cmdch . A prototype com- 
mand character is chosen which is used in all capabilities. This 
character is given in the cmdch capability to identify it. The follow- 
ing convention is supported on some UNIX systems: The environ- 
ment is to be searched for a CC variable, and if found, all 
occurrences of the prototype character are replaced with the char- 
acter in the environment variable. 


( lf the terminal has a settable command character, such as the TEK- 


Terminal descriptions that do not represent a specific kind of known 
terminal, such as switch , dialup , patch , and network , should 
include the gn (generic) capability so that programs can complain 
that they do not know how to talk to the terminal. (This capability 
does not apply to virtua/ terminal descriptions for which the escape 
sequences are known.) 


If the terminal uses xon/xoff handshaking for flow control, give xon . 
Padding information should still be included so that routines can 
make better decisions about costs, but actual pad characters will not 
be transmitted. 


If the terminal has a “meta key’ which acts as a shift key, setting 
the 8th bit of any character transmitted, this fact can be indicated 
with km . Otherwise, software will assume that the 8th bit is parity 
and it will usually be cleared. If strings exist to turn this “meta 
mode” on and off, they can be given as smm and rmm. 
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If the terminal has more lines of memory than will fit on the screen 


at once, the number of lines of memory can be indicated withIm.A ~ — 
value of Im #0 indicates that the number of lines is not fixed, but . 


that there is still more memory than fits on the screen. 


lf the terminal is one of those supported by the UNIX virtual terminal 
protocol, the terminal number can be given as vt. 


Media copy strings which control an auxiliary printer connected to 
the terminal can be given as mc0Q: print the contents of the screen, 
mc4 : turn off the printer, and mcS : turn on the printer. When the 
printer is on, all text sent to the terminal will be sent to the printer. It 
is undefined whether the text is also displayed on the terminal 
screen when the printer is on. A variation me5p takes one parame- 
ter, and leaves the printer on for as many characters as the value of 
the parameter, then turns the printer off. The parameter should not 
exceed 255. All text, including mc4 , is transparently passed to the 
printer while an mcS5p is in effect. 


Strings to program function keys can be given as pfkey , pfloc , 
and pfx . Each of these strings takes two parameters: the function 
key number to program (from 0 to 10) and the string to program it 
with. Function key numbers out of this range may program unde- 


fined keys in a terminal dependent manner. The difference between  ~ - 


the capabilities is that pfkey causes pressing the given key to be 


the same as the user typing the given string; pfloc causes the string ~ 


to be executed by the terminal in local; and pfx causes the string to 
be transmitted to the computer. 


Glitches and Braindamage 


Hazeltine terminals, which do not allow ©” characters to be displayed 
should indicate hz. 


Terminals which ignore a linefeed immediately after an am wrap, 
such as the Concept and vt100, should indicate xenl. 


If el is required to get rid of standout (instead of merely writing nor- 
mal text on top of it), xhp should be given. 


Teleray terminals, where tabs turn all characters moved over to 
blanks, should indicate xt (destructive tabs). This glitch is also 
taken to mean that it is not possible to position the cursor on top of 
a “magic cookie’, that to erase standout mode it is instead neces- 
sary to use delete and insert line. 


The Beehive Superbee, which is unable to correctly transmit the 
escape or control C characters, has xsb , indicating that the f1 key _ 
is used for escape and f2 for control C. (Only certain Superbees | 
have this problem, depending on the ROM.) ° 
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FILES 


Other specific terminal problems may be corrected by adding more 
capabilities of the form xx. 


Similar Terminals 


If there are two very similar terminals, one can be defined as being 
just like the other with certain exceptions. The string capability use 
can be given with the name of the similar terminal. The capabilities 
given before use override those in the terminal type invoked by use 
. A capability can be cancelled by placing xx@ to the left of the 
Capability definition, where xx is the capability. For example, the 
entry 


2621-nl, smkx(@, rmkx(@, use= 2621, 


defines a 2621-nl that does not have the smkx or rmkx capabilities, 
and hence does not turn on the function key labels when in visual 
mode. This is useful for different modes for a terminal, or for dif- 
ferent user preferences. 


/ust/lib/terminfo/?/* files containing terminal descriptions 


SEE ALSO 
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curses(3X), printf(3S), term(5). 
tic(1M) in the Sys5 UNIX Administrator Reference Manual. 
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NAME 
utmp, wtmp — utmp and wtmp entry formats os 
#include <sys/types.h> 
#include <utmp.h> 

DESCRIPTION | 
These files, which hold user and accounting information for such 
commands as who (1), write (1), and login (1), have the following 
structure as defined by <utmp.h> : 


#define UTMP_FILE  ‘/etc/utmp”" 
#define WITMP_FILE  ‘"/etc/wtmp” 
#define ut_name ut_user 


struct utmp { 


char ut_user[8}; /* User login name */ | 
char ut_id[4]; /* /etc/inittab id (usually line #) */ 
char ut_line[12]; /* device name (console, Inxx) */ 
short ut_pid; /* process id */ _ 

short ut_type; /* type of entry */ 


struct exit_status { 
short e_termination; /* Process termination status -/ 


short e_exit; /*x Process exit status */ | 
} ut_exit; /*« The exit status of a process es 
| * marked as DEAD_PROCESS. */ 
time_t —_ ut_time; /* time entry was made */ 


i 


/* Definitions for ut_type */ 

#define EMPTY 0 

#define RUN_LVL 1 

#define BOOT_TIME 2 

#define OLD_TIME 3 

#define NEW_TIME 4 

#define INIT.PROCESS 5 /* Process spawned by "init" «/ 
#define LOGIN-PROCESS 6 /* A "getty" process waiting for login */ 
#define USER_PROCESS 7 /* A user process */ 

#define DEAD_PROCESS' 8 

#define ACCOUNTING 9 

#define UTMAXTYPE ACCOUNTING  /*« Largest legal value of ut_type */ 
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| /* Special strings or formats used in the "ut_line” field when +/ 
ae, /* accounting for something other than a process */ 
( /* No string for the ut_line field can be more than 11 chars + */ 
— /* a NULL in length «/ 
#define RUNLVL_MSG "run—level %c" 
#define BOOT_MSG__ "system boot" 
#define OTIME_MSG __ "old time” 
#define NTIME_MSG_ "new time" 


FILES 
/usr/include/utmp.h 
/etc/utmp 
/etc/wtmp 


SEE ALSO 
getut(3C). 
login(1), who(1), write(1) in the Sys5 UNIX User Reference Manual. 


C 
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_ NAME 
( | intro — introduction to miscellany 


DESCRIPTION 
This section describes miscellaneous facilities such as macro pack- 
ages, character set tables, etc. 
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NAME | 

ascii - map of ASCII character set —_ 
SYNOPSIS | St 

cat /usr/pub/ascii aa 
DESCRIPTION | 
Ascii is a map of the ASCII character set, giving both octal and hex- 
adecimal equivalents of each character, to be printed as needed. It 
contains: 
‘000 nul |001 soh ‘002 stx O03 etx (004 e0t i005enq 006 ack |007bel | 
010bs [O11 ht (O12ni (013 vt [014np [015cr j016s0 O17si | 
O20 dle [021 dc1 (022 dc2 |023dc3 |024dc4 !025nak 026 syn i027 etb | 
030 can |031em [032 sub (033 esc |034fs {035gs ‘036rs ‘O37us_ | 
‘040 sp [041! 042" (043 # (044$ 045% (046& |047 | 
1050 ( 1051 ) 052 * 1053 + =| 054, 055- '056. 1057 | | 
0600 |0611 10622 §6=©|0633 =| 0644 0655 ji0666 |0677 | 
0708 |0719 #|072: (073 : 1074< |075= |076> #1077? | 
‘100@ = |101A (|102B |103C |104D |105E 106F '107G | 
10H [1111 12300 1443 K «=o 144L OU 415M 116N (1170 | 
'120P |121Q |122R !123S |124T 8 |125U 126V 127 W 
130X 1131Y 1132Z (1393[ 1194. 1135] (186° 1137. 
140 i141a |142b '143c (144d |145e (146f 147g -- | 
'150h (151i 1152 j 153k | 1541 155m 1156n  :15760 
160p i161q (|162r '163s (164t /165u |166v 167 wo 
i170x li7ty |1722z2 11734 174) 1175 } 176° 177 del 
/OOnul | 01soh | 02stx ‘O3etx (O4e0t | O05enq | O6 ack | O7bel 
'08bs j|O9ht | Oani Obvt !O0cnp !Odcr |0eso | Ofsi 
'10dle ji 41dcet |12dc2 (13dc3 §14dc4 | 15nak | 16syn | 17 etb 
'18can |19em !1asub | 1besc | tcfs 'idgs fiiers | ifus | 
'20sp | 21! | 22" (23# | 24$ 125% | 26& 27 | 
| 28 ( | 29 ) | 2a" \2b+ | ac, | 2d- | 2e. | 2f / | 
| 300 1311 | 32 2 | 33 3 1344. | 355 | 36 6 | 377 | 
| 38 8 | 399 | Sac 3b: | 3c < isd= ges. ‘ist? | 
|\40@ | 41A 1428 '43C | 44D \45E | 46F \47G | 
| 48H | 49 | | daJ | 4b K l4cL |4dM | 4eN | 40 | 
/ 50 P 151Q |52R | 53S | 54 T 155 U 56 V 57 WC 
58 X | 59 Y | 5aZ 5b | | 5c \ | 5d | | 5e° | Sf | 
| 60 | 61a | 62 b 63¢ | 64d | 65e 66 f 67g | 
68h | 69 i | 6a j | 6b k | 6c | '6dm | Gen  6fo | 
| 70 p | 71iq |72r 73 § |74t | 75 u 76v 77 w | 
| 78 x | 79 y | 7az | 7b 4 | 7c | | 7d } | 7e- 7f del | 

| 7“ oe 

FILES , 

/ust/pub/ascii Ss 
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_ NAME 


DESCRIPTION 
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environ — user environment 


An array of strings called the “environment” is made available by 
exec (2) when a process begins. By convention, these strings have 
the form “name=value”. The following names are used by various 
commands: 


PATH 


HOME 


TERM 


TZ 


The sequence of directory prefixes that sh (1), time (1), 
nice (1), nohup (1), etc., apply in searching for a file known 
by an incomplete path name. The prefixes are separated 
by colons (:). Login (1) sets PATH= :/bin:/usr/bin . 

Name of the user's login directory, set by login (1) from the 
password file passwd (4). 

The kind of terminal for which output is to be prepared. 
This information is used by commands, such as mm (1) or 
tplot (1G), which may exploit special capabilities of that ter- 
minal. 

Time zone information. The format is xxx n zzz where xxx 
is standard local time zone abbreviation, n is the difference 
in hours from GMT, and zzz is the abbreviation for the 
daylight-saving local time zone, if any; for example, 
EST5EDT . 


Further names may be placed in the environment by the export 
command and “name=value” arguments in sh (7), or by exec (2). It 
is unwise to conflict with certain shell variables that are frequently 
exported by .profile files: MAIL , PS1 , PS2, IFS. 


SEE ALSO 


exec(2). 


env(1), login(1), sh(1), mm(1), nice(1), nohup(1), time(1), tplot(1G) 
in the Sys5 UNIX User Reference Manual. 
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NAME 


eanchar — special character definitions for eqn and neqn 


SYNOPSIS Nee 
eqn /usr/pub/eqnchar [ files ] | troff [ options ] 


neqn /usr/pub/eqnchar [ files ] | nroff (1) [ options ] 
eqn -Taps /usr/pub/apseqnchar [ files ] | troff [ options ] 
eqn -Tcat /usr/pub/cateqnchar [ files ] | otroff [ options |] 


DESCRIPTION 
Egnchar contains troff(1) and nroff(1) character definitions for con- 
structing characters that are not available on a phototypesetter. 
These definitions are primarily intended for use with eqn(1) and 
neqn; eqnchar contains definitions for the following characters: 


ciplus —_ciplus_ || | Square square 

citimes _— citimes langle langle circle circle 

wig wig rangle rangle biot blot 

—Wig —wig hbar Abar bullet bullet 

>wig >wig ppd ppd ~~ prop prop 

<wig <wig <-> <-+ empty empty 

=Wwig =Wig <=> <> member member ~— 
star star |< I< nomem nomem = ~~ 
bigstar _bigstar |> |> cup cup 

=dot =dot ang ang cap cap 

orsign orsign rang rang incl incl 

andsign andsign 3dot 3dot subsetsubset 
= del =del thf thf Supset supset 

oppA oppA quarter quarter !subset ‘subset 

oppE OoppE 3quarter S3quarter Isupset!supset 
angstrom angstrom degree degree _ scrLscrL 

ae a a 


Apsegqnchar is a version of eqnchar tailored for the Autologic APS-5 
phototypesetter. This will not look optimal on other photo- 
typesetters. Cateqnchar is the old eqnchar tailored for the Wang 
CAT and the old otroff. Until a phototypesetter-independent version 
of eqnchar is available, egqnchar should be a link to the default ver- 
sion on each system. The standard default is apseqnchar. © 


FILES 
/usr/pub/eqnchar a. 
/ust/pub/apseqnchar ae 
/usr/pub/cateqnchar 
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_ SEE ALSO 
- eqn(1), nroff(1), troff(1). Sys5 UNIX User Reference Manual. 


( | 
:, ye 
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NAME | 7 
_ fentl — file control options = 
SYNOPSIS Se ge 
#include <fcntl.h> 
DESCRIPTION 


The fent! (2) function provides for control over open files. This 
include file describes requests and arguments to fcentl and open 

(2). 

/* Flag values accessible to open(2) and fentl(2) «/ 

/* (The first three can only be set by open) «/ 

#define O_RDONLY 0 

#define O_WRONLY 1 

#define O_RDWR 2 

#define O_NDELAY 04 /* Non-blocking VO */ 

#define O_APPEND 010 /* append (writes guaranteed at the end) */ 


/* Flag values accessible only to open(2) */ 
#define O_CREAT 00400  /* open with file create (uses third open arg)=/ 
#define O_TRUNC 01000 = /* open with truncation */ 

#define O_EXCL 02000 = /* exclusive open */ 

/* fentl(2) requests */ 
#define F_DUPFD 
#define F_GETFD 
#define F_SETFD 
#define F_GETFL 
#define F_SETFL 


SEE ALSO : 
fentl(2), open(2). 


/* Duplicate fildes */ 
/« Get fildes flags */ 
/* Set fildes flags */ 
/* Get file flags «/ 
/* Set file flags */ 


AWNhM —- © 
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NAME 
font — description files for device-independent troff 
SYNOPSIS 
troff —T ptty 
DESCRIPTION 


For each phototypesetter supported by troff(1) and available on this 
system, there is a directory containing files describing the device and 
its fonts. This directory is named /usr/lib/font/devptty where ptty is 
the name of the phototypesetter. Currently the only ptty supported is 
aps for the Autologic APS—5. 


For a particular phototypesetter, the ASCII file DESC in the directory 
/usr/lib/font/devptty describes its characteristics. Each line starts 
with a word identifying the characteristic and followed by appropriate 
specifiers. Blank lines and lines beginning with a # are ignored. 


The legal lines for DESC are: 


res num 


hor num 

vert num 
unitwidth num 
sizescale num 
paperwidth num 
paperlength num 
spare1 num 


spare2 num 


sizes num num... 


fonts num name ... 


resolution of device in basic increments 
per inch 


smallest unit of horizontal motion 
smallest unit of vertical motion 

pointsize in.which widths are specified 
scaling for fractional pointsizes 

width of paper in basic increments 

length of paper in basic increments 
available for use 

available for use 

list of pointsizes available on typesetter 
number of initial fonts followed by the 


names of the fonts. For example: 
fonts 4RIBS 


this always comes last in the file and is 
on a line by itself. Following it is the list 
of special character names for this dev- 
ice. Names are separated by a space or 
a newline. The list can be as long as 
necessary. Names not in this list are not 
allowed in the font description files. 


charset 


Res is the basic resolution of the device in increments per inch. Hor 

and vert describe the relationships between motions in the horizontal 

and vertical directions. If the device is Capable of moving in single 

basic increments in both directions, both hor and vert would have 

po values of 1. If the vertical motions only take place in multiples of two 
| basic units while the horizontal motions take place in the basic incre- 
ments, then hor would be 1, while vert would be 2. Unitwidth is the 

pointsize in which all width tables in the font description files are 

given. Troff automatically scales the widths from the unitwidth size 
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to the pointsize it is working with. Sizescale is not currently used 


and is 1. 


sheet of paper in the basic increments. 


For each font supported by the phototypesetter, there is also an 
ASCII file with the same name as the font (e.g., R, 1, CW). The format 
for a font description file is: 


name name name of the font, such as R or CW 
internalname name internal name of font 


special sets flag indicating that the font is spe- 
cial 


ligatures name ...Q Sets flag indicating font has ligatures. 
The list of ligatures follows and is ter- 
minated by a zero. Accepted ligatures 
are: ff fi fl ffi ffl. 


spare 1 available for use 


spacewidth num — width of space if something other than 
1/3 of \(em is desired as a space. 


charset The charset must come at the end. Each 
| line following the word charset describes 


one character in the font. Each line has y 


one of two formats: 
name width kerningcode 
name * 


where name is either a single ASCII character or a special 
character name from the list found in DESC . The width is in 
basic increments. The kerning information its 1 if the charac- 
ter descends below the line, 2 if it rises above the letter ’a’, 
and 3 if it both rises and descends. The kerning information 
for special characters is not used and so may be O. The code 
is the number sent to the typesetter to produce the character. 
The second format is used to indicate that the character has 
more than one name. The double quote indicates that this 
name has the same values as the preceding line. The kerning 
and code fields are not used if the width field is a double 
quote character. 


Troff and its postprocessors read this information from binary 
files produced from the ASCIl files by a program distributed 
with troff called makedev . For those with a need to know, a 
description of the format of these files follows: 


The file DESC.out starts with the dev structure, defined by 
dev.h: 


/* 
dev.h: characteristics of a typesetter 
a 
struct dev { 
short _ filesize; /* number of bytes in file, */ 
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/* excluding dev part */ 
short res; /* basic resolution in goobies/inch */ 
short hor; /* goobies horizontally */ 
short vert; 
short unitwidth; /* size at which widths are given*/ 
short nfonts; /* number fonts physically available */ 
short nsizes; /* number of pointsizes */ 
short sizescale; /* scaling for fractional pointsizes */ 


short paperwidth; /* max line length in units */ 
short paperlength; /* max paper length in units */ 


short nchtab; /* number of funny names in chtab */ 
short Ichname; /* length of chname table */ 

short sparet; /* in case of expansion */ 

short spare2; 

}s 


Filesize is just the size of everything in DESC.out excluding the 
dev structure. Nfonts is the number of different font positions 
available. Nsizes is the number of different pointsizes sup- 
ported by this typesetter. Nchtab is the number of special 
character names. Lchname is the total number of characters, 
including nulls, needed to list all the special character names. 
At the end of the structure are two spares for later expan- 
sions. 


Immediately following the dev structure are a number of 
tables. First is the sizes table, which contains nsizes + 1 
shorts (a null at the end), describing the pointsizes of text 
available on this device. The second table is the 
funny_char_index_table . It contains indices into the table 
which follows it, the funny_char_strings . The indices point to 
the beginning of each special character name which is stored 
in the funny_char_strings table. The funny_char_strings table 
is Ichname characters long, while the funny_char_index_table 
is nchtab shorts long. 


Following the dev structure will occur nfonts {font}.out files, 
which are used to initialize the font positions. These 
{font}.out files, which also exist as separate files, begin with a 
font structure and then are followed by four character arrays: 


struct font { /* characteristics of a font */ 

char nwfont; /* number of width entries */ 

char specfont; /* 1 == special font */ 

char ligfont; /* 1 == ligatures exist on this font */ 
char spare; /* unused for now */ 

char namefont [10]; /* name of this font, e.g., R */ 

char intname [10]; /* internal name of font, in ASCII */ 
} 


The font structure tells how many defined characters there are 
in the font, whether the font is a "special" font and if it con- 
tains ligatures. It also has the ASCII name of the font, which 
should match the name of the file it appears in, and the 
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internal name of the font on the typesetting device (intname). 
The internal name is independent of the font position and 


name that troff knows about. For example, you might say ~ 


mount R in position 4, but when asking the typesetter to actu- ° 
ally produce a character from the R font, the postprocessor 
which instructs the typesetter would uSe intname. 


The first three character arrays are specific for the font and 
run in parallel. The first array, widths, contains the width of 
each character relative to unitwidth. Unitwidth is defined in 
DESC. The second array, kerning, contains kerning informa- 
tion. If a character rises above the letter ‘a’, 02 is set. If it 
descends below the line, 01 is set. The third array, codes, 
contains the code that is sent to the typesetter to produce the 
character. 


The fourth array is defined by the device description in DESC. 
It is the fontLindex_table. This table contains indices into the 
width, kerning, and code tables for each character. The order 
that characters appear in these three tables is arbitrary and 
changes from one font to the next. In order for troff to be able 
to translate from ASCII and the special character names to 
these arbitrary tables, the font_index_table is created with an 
order which is constant for each device. The number of 
entries in this table is 96 plus the number of special character 
names for this device. The value 96 is 128 - 32, the number 
of printable characters in the ASCII alphabet. To determine 
whether a normal ASCII character exists, troff takes the ASCII . 
value of the character, subtracts 32, and looks in the 
font_index_table. lf it finds a 0, the character is not defined in 
this font. If it finds anything else, that is the index into widths, 
kerning and codes that describe that character. 


To look up a special character name—for example \(pl , the 
mathematical plus sign—and determine whether it appears in 
a particular font or not, the following procedure is followed. A 
counter is set to 0 and an index to a special character name 
is picked out of the counter’th position in the 
funny_char_index_table. A string comparision is performed 
between funny_char_strings [funny_char_index_table[counter]] 
and the special character name, (in our example pl), and if it 
matches, then troff refers to this character as (96 + counter). 
When it wants to determine whether a specific font supports 
this character, it looks in font_index_table [(96 + counter], 
(see below), to see whether there is a 0, meaning the charac- 
ter does not appear in this font, or number, which is the index 
into the widths, kerning, and codes tables. 


Notice that since a value of O in the font_index_table indicates 
that a character does not exist, the Oth element of the width, 
kerning, and codes arrays are not used. For this reason the « 
Oth element of the width array can be used for a special pur- . 
pose, defining the width of a space for a font. Normally a 

space is defined by troff to be 1/3 of the width of the \(em 
character, but if the Oth element of the width array is non- 
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zero, then that value is used for the width of a space. 


“™:. SEE ALSO 
troff(1), troff(5). 


FILES 
/usr/lib/font/dev{X}/DESC.out description file for phototypesetter X 
/usr/lib/font/dev{X}/{font}.out font description files for photo- 
typesetter X 
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NAME 


man — macros for formatting entries in this manual 


SYNOPSIS 


nroff —man files | 
troff -man [ -rs1 ] files 


DESCRIPTION 


Page 1 


These troff(1) macros are used to lay out the format of the entries of 
this manual. A_ skeleton entry may be found in the file 
/usr/man/u_man/manQ/skeleton. These macros are used by the 
man(1) command. 


The default page size is 8.511, with a 6.510 text area; the -rs1 
option reduces these dimensions to 6X9 and 4.758.375, respec- 
tively; this option (which is not effective in nroff(1) ) also reduces the 
default type size from 10-point to 9-point, and the vertical line spac- 
ing from 12-point to 10-point. The -rV2 option may be used to set 
certain parameters to values appropriate for certain Versatec 
printers: it sets the line length to 82 characters, the page length to 
84 lines, and it inhibits underlining; this option should not be con- 
fused with the —Tvp option of the man(1) command, which is avail- 
able at some UNIX system sites. 


Any text argument below may be one to six “words”. Double — 
quotes ( may be used to include blanks in a “word”. If text is * 


empty, the special treatrnent is applied to the next line that contains 
text to be printed. For example, .f may be used to italicize a whole 
line, or .SM followed by .B to make small bold text. By default, 
hyphenation is turned off for nroff(1), but remains on for troff(1). 


Type font and size are reset to default values before each para- 
graph and after processing font- and size-setting macros, e.g., 1, 
-RB, .SM. Tab stops are neither used nor set by any macro except 
-DT and .TH. 


Default units for indents in are ens. When in is omitted, the previ- 
ous indent is used. This remembered indent is set to its default 
value (7.2 ens in troff(1), 5 ens in nroff—this corresponds to 0.5 in 
the default page size) by .TH, .P, and .RS, and restored by .RE. 


‘THtscn Set the title and entry heading; t is the title, s is the sec- 
tion number, c is extra commentary, e.g., ‘local’, n is 
new manual name. Invokes .DT (see below). 

SH text Place subhead text, e.g., SYNOPSIS , here. 

SS fext Place sub-subhead fext , e.g., Options , here. 

.B text Make text bold. 

I text Make text italic. 

SM text Make text 1 point smaller than default point size. 
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Ria ob Concatenate roman a with italic b , and alternate these 
two fonts for up to six arguments. Similar macros alter- 
nate between any two of roman, italic, and bold: 

JR .RB .BR JB .BI 


.P Begin a paragraph with normal font, point size, and 
indent. .PP is a synonym for .P. 

“HP in Begin paragraph with hanging indent. 

TP in Begin indented paragraph with hanging tag. The next 


line that contains text to be printed is taken as the tag. 
If the tag does not fit, it is printed on a separate line. 


AP tin Same as .TP in with tag t; often used to get an indented 
paragraph without a tag. 

.RS in Increase relative indent (initially zero). Indent all output 
an extra in units from the current left margin. 

-RE k Return to the k th relative indent level (initially, kK =1; k 


=0 is equivalent to k =17); tf k is omitted, return to the 
most recent lower indent level. 

.PMm Produces proprietary markings; where m may be P for 
PRIVATE, N for NOTICE, BP for BELL LABORATORIES 
PROPRIETARY, or BR for BELL LABORATORIES RES- 


TRICTED. 
.DT Restore default tab settings (every 7.2 ens in troff(1), 5 
( | ens in nroff(1)). 
oe PD v Set the interparagraph distance to v vertical spaces. If 


v is omitted, set the interparagraph distance to the 
default value (0.4v in troff(1), 1v in nroff(1)). 


The following strings are defined: 


\#R ® in troff(1), (Reg.)f1 in nroff. 
\#$ Change to default type size. 
\#(Tm Trademark indicator. 


The following number registers are given default values by .TH: 


IN Left margin indent relative to subheads (default is 7.2 
| ens in troff(1), 5 ens in nroff(1)). 
LL Line length including IN . 
PD Current interparagraph distance. 
CAVEATS 


In addition to the macros, strings, and number registers mentioned 

above, there are defined a number of internal macros, strings, and 

number registers. Except for names predefined by froff(1) and 

number registers d, m, and y, all such internal names are of the 

po form XA, where X is one of ), ], and }, and A stands for any 
( alphanumeric character. 


lf a manual entry needs to be preprocessed by eqn(1) (or neqn), 
and/or tb/{1), it must begin with a special line (described in man(1)), 
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causing the man command to _ invoke’ the appropriate 
preprocessor(s).. 


The programs that prepare the Table of Contents and the Permuted 
Index for this Manual assume the NAME section of each entry con- 
sists of a single line of input that has the following format: 


name[, name, name ...] \— explanatory text 


The macro package increases the inter-word spaces (to eliminate 
ambiguity) in the SYNOPSI/S section of each entry. 


The macro package itself uses only the roman font (so that one can 


replace, for example, the bold font by the constant-width font (CW). 
Of course, if the input text of an entry contains requests for other 


fonts (e.g., .1, .RB, \fl.), the corresponding fonts must be mounted. 
FILES 

/usr/lio/tmac/tmac.an 

/usr/lib/macros/cmp.n.[dt].an 

/usr/lib/macros/ucmp.n.an 

/usr/man/[uap|_man/man0/skeleton 
SEE ALSO 

ocw(1), eqn(1), man(1), nroff(1), tol(1), tc(1), troff(1). 
BUGS 

If the argument to .TH contains any blanks and is not enclosed by 

double quotes ( there will be strange irregular dots on the output. 
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NAME 
( math — math functions and constants 


_ SYNOPSIS 
#include <math.h> 


DESCRIPTION 
This file contains declarations of all the functions in the Math Library 
(described in Section 3M), as well as various functions in the C 
Library (Section 3C) that return floating-point values. 


It defines the structure and constants used by the matherr (3M) 
error-handling mechanisms, including the following constant used as 
an error-return value: 


HUGE The maximum value of a_ single-precision 
floating-point number. 


The following mathematical constants are defined for user conveni- 


ence: 

MLE The base of natural logarithms (e ). 

M_LOG2E © The base-2 logarithm of e . 

M_LOG10E The base-10 logarithm of e. 

a M_LN2 The natural logarithm of 2. 
( | M_LN10 The natural logarithm of 10. 

M_PI The ratio of the circumference of a circle to 
its diameter. (There are also several frac- 
tions of its reciprocal and its square root.) 

M_SQRT2 The positive square root of 2. 

M_SQRT1_2 The positive square root of 1/2. 


For the definitions of various machine-dependent “constants,” see 
the description of the <va/ues.h> header file. 


FILES 
/usr/include/math.h 


SEE ALSO 
intro(3), matherr(3M), values(5). 


( | 
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mm — the MM macro package for formatting documents 


SYNOPSIS 


mm [ options ] [ files ] 
nroff —mm [ options ] [ files ] 
nroff —cm [ options ] [ files | 


mmt [ options ] [ files ] 
troff -mm [ options ] [ files ] 


DESCRIPTION 


This package provides a formatting capability for a very wide variety 
of documents. It is the standard package used by the BTL typing 
pools and documentation centers. The manner in which a docu- 
ment is typed in and edited is essentially independent of whether 
the document is to be eventually formatted at a terminal or is to be 
phototypeset. See the references below for further details. 


The -—mm option causes nroff(1) and troff(1) to use the non- 
compacted version of the macro package, while the —cm option 
results in the use of the compacted version, thus speeding up the 
process of loading the macro package. 


FILES 
/usr/lib/tmac/tmac.m pointer to the non-compacted version 
of the package 
/usr/lib/macros/mm(nt] non-compacted version of the pack- 
age 
/usr/lib/macros/cmp.n.[dt].m compacted version of the package 
/usr/lib/macros/ucmp.n.m initializers for the compacted version 
of the package 
SEE ALSO 
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mm(1), mmt(1), nroff(1), troff(1). 
MM—Memorandum Macros by D.W. Smith and J.R. Mashey. 
Typing Documents with MM by D.W. Smith and E.M. Piskorik. 
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NAME 


mosd — the OSDD adapter macro package for formatting documents 


SYNOPSIS 


osdd [ options | [ files ] 
mm —mosd [ options | [ files ] 
nroff —-mm -—mosd [ options | [ files ] 


nroff —cm —mosd [ options | [ files | 


mmt —mosd [ options | [ files | 
troff -mm -—mosd [ options | [ files | 


DESCRIPTION 
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The OSDD adapter macro package is a tool used in conjunction with 
the MM macro package to prepare Operations Systems Deliverable 
Documentation. Many of the OSDD Standards are different from the 
default format provided by MM. The OSDD adapter package sets the 
appropriate MM options for automatic production of the OSDD Stan- 
dards. The OSDD adapter package also generates the correct 
OSDD page headers and footers, heading styles, Table of Contents 
format, etc. 


OSDD document (input) files are prepared with the MM macros. 
Additional information which must be given at the beginning of the 
document file is specified by the following string definitions: 

.ds H1 document-number 

.ds H2 section-number 

.ds H3 issue-number 

.ds H4 date 

.ds H5 rating 


The document-number should be of the standard 10-character for- 
mat. The words “Section” and “Issue” should not be included in the 
string definitions; they will be supplied automatically when the docu- 
ment is printed. For example: 

.ds Hi OPA-1P135-01 

.ds H2 4 

.ds H3 2 
automatically produces 

OPA-1P135-01 

Section 4 

Issue 2 
as the document page header. Quotation marks are not used in 
string definitions. 


If certain information is not to be included in a page header, then the 
string is defined as null. In other words, ".ds H2"” means that there 
is no section-number. 
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The OSDD Standards require that the Table of Contents be num- 
bered beginning with Page 7. By default, the first page of text will . 
be numbered Page 2. If the Table of Contents has more than one . 
page, for example n, then either -—rPn+7 must be included as a 
command line option or .nr P n must be included in the document 
file. For example, if the Table of Contents is four pages then use 
-—rP5 on the command line or .nr P 4 in the document file. 


The OSDD Standards require that certain information such as the 
document rating appear on the Document Index, or on the Table of 
Contents page if there is no index. By default, it is assumed that an 
index has been prepared separately. If there is no index, the follow- 
ing must be included in the document file: 
nr Did 

This will ensure that the necessary information is included on the 
Table of Contents page. 


The OSDD Standards require that all numbered figures be placed at 
the end of the document. The .Fg macro is used to produce full 
page figures. This macro produces a blank page with the appropri- 
ate header, footer, and figure caption. Insertion of the actual figure 
on the page is a manual operation. The macro usage is 
.Fg page-count “figure caption" 

where page-count is the number of pages required for a multi-page ~ 
figure (default 1 page). 


The .Fg macro cannot be used within the document unless the final 
.Fg in a series of figures is followed by a .SK macro to force out the 
last figure page. 


The Table of Contents for OSDD documents (see Figure 4 in Section 
4.1 of the OSDD Standards) is produced with: 

Bigs 

System Type 

System Name 

Document Type 

Td | 
The .Te / .Td macros are used instead of the .TC macro from MM. 


The .PM macro may be used to generate proprietary manne: — see 
the MM document for legal styles. 


The .P macro is used for paragraphs. The Np register is set 
automatically to indicate the paragraph numbering style. It is very 
important that the .P macro be used correctly. All paragraphs 
{including those immediately following a .H macro) must use a .P 


macro. Unless there is a .P macro, there will not be a number gen- ~ 


erated for the paragraph. Similarly, the .P macro should not be ° 
used for text which is not a paragraph. The .SP macro may be 
appropriate for these cases, e.g., for “paragraphs” within a list item. 
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FILES 


The page header format is produced automatically in accordance 
with the OSDD Standards. The OSDD Adapter macro package uses 
the .TP macro for this purpose. Therefore the .TP macro normally 
available in MM is not available for users. 


/usr/lib/tmac/tmac.osd 


SEE ALSO 
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mm(4), mmt(1), nroff(4), troff(1), mm(5). 


September 19, 1986 


MPTX(5) UNIX Sys5 MPTX(5) 


NAME 


mptx — the macro package for formatting a permuted index 


SYNOPSIS 


nroff —mptx [ options ] [ files ] 
troff —mptx [ options | [ files ] 


DESCRIPTION 


This package provides a definition for the .xx macro used for for- 
matting a permuted index as produced by ptx(1). This package 
does not provide any other formatting capabilities such as headers 
and footers. If these or other capabilities are required, the mptx 
macro package may be used in conjunction with the MM macro 
package. In this case, the -mptx option must be invoked after the 
—mm call. For example: 


nroff —-cm —mptx file 


or 
mm —moptx file 
FILES 
/usr/lib/tmac/tmac.ptx pointer to the non-compacted version of the 
package 
/usr/lib/macros/ptx non-compacted version of the package 
SEE ALSO 
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mm(1), nroff(1), ptx(1), troff(1), mm(5). 
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mv — a troff macro package for typesetting viewgraphs and slides 


__ SYNOPSIS 


mvt [ -—a | [ options | [ files ] 
troff [ -a ] [ -rX1 ] -mv [ options ] [ files ] 


DESCRIPTION 
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This package makes it easy to typeset viewgraphs and projection 
slides in a variety of sizes. A few macros (briefly described below) 
accomplish most of the formatting tasks needed in making tran- 
sparencies. All of the facilities of troff(1), eqn(1), and fb/(1) are 
available for more difficult tasks. 


The output can be previewed on most terminals, and, in particular, 
on the TEKTRONIX 4014. For this device, specify the -rX1 option 
(this option is automatically specified by the mvt 
command-—q.v.—when that command is invoked with the —T4014 
option). To preview output on other terminals, specify the —a option. 


The available macros are: 


VS [n] [/] [e] Foil-start macro; foil size is to be 7’’ x7’’; n is the 
foil number, / is the foil identification, d is the 
date; the foil-start macro resets all parameters 
(indent, point size, etc.) to initial default values, 
except for the values of / and d arguments inher- 
ited from a previous foil-start macro; it also 
invokes the .A macro (see below). 


The naming convention for this and the following 
eight macros is that the first character of the 
name (V or S) distinguishes between viewgraphs 
and slides, respectively, while the second charac- 
ter indicates whether the foil is square (S), small 
wide (w), small high (h), big wide (W), or big high 
(H). Slides are “skinnier” than the corresponding 
viewgraphs: the ratio of the longer dimension to 
the shorter one is larger for slides than for view- 
graphs. As a result, slide foils can be used for 
viewgraphs, but not vice versa; on the other hand, 
viewgraphs can accommodate a bit more text. 


.Vw [n] [4] [a] Same as .VS, except that foil size is 7’’ wide x 
5’" high. 


-Vh _[n] [/ [a] Same as .VS, except that foil size is 5'’x7"’. 
VW [nr] [/] [a] Same as .VS, except that foil size is 7’’ x5.4"’. 
-VH [n] [/] [a] Same as .VS, except that foil size is 7’’ x9’’. 
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.Sw [n] [/] [co] Same as .VS, except that foil size is 7’’ x 5”’. 
Sh [/] [f [co] Same as .VS, except that foil size is 5'’x7’’. _—_ 
\ 


.SW [n] [4] [1] Same as .VS, except that foil size is 7"’x5.4’"..  \ 
.SH [n] [] [o] | Same as .VS except that foil size is 7’’x9’’. 


A [x] Place text that follows at the first indentation level 
(left margin); the presence of x suppresses the % 
line spacing from the preceding text. 


.B [m [s] ] Place text that follows at the second indentation 
level; text is preceded by a mark; m is the mark 
(default is a large bullet); s is the increment or 
decrement to the point size of the mark with 
respect to the prevailing point size (default is 0); if 
S is 100, it causes the point size of the mark to be 
the same as that of the default mark. 


.C [m [s] ] Same as .B, but for the third indentation level; 
default mark is a dash. 

.D [m [s] ] Same as .B, but for the fourth indentation level; 
default mark is a small bullet. | 

.T string String is printed as an over-size, centered title. 

I [in] [a [x] ] Change the current text indent (does not affect 


titles); in is the indent (in inches unless dimen- —~ 
sioned, default is 0); if in is signed, it is an incre- 
ment or decrement; the presence of a invokes the 
.A macro (see below) and passes x (if any) to it. 


S[p}{] | Set the point size and line length; p is the point 
size (default is ‘“previous’); if p is 100. the point 
size reverts to the initial default for the current 
foil-start macro; if p is signed, it is an increment or 
decrement (default is 18 for .VS, .VH, and .SH, 
and 14 for the other foil-start macros); / is the line 
length (in inches unless dimensioned; default is 
4.2’’ for .Vh, 3.8’’ for .Sh, 5’’ for .SH, and 6”’ for 
the other foil-start macros). 


DFnf{{[nf Define font positions; may not appear within a 


foil’s input text (i.e., it may only appear after all 
the input text for a foil, but before the next foil- 


start macro); n is the position of font ({) up to four 
“n (f)" pairs may be specified; the first font 


named becomes the prevailing font; the initial set: 
ting is (H is a synonym for G): | ae 
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DF 1H2/13B45 


-DV [a] [5] [c] [co] Alter the vertical spacing between indentation lev- 
els; a is the spacing for .A, 5 is for .B, c is for .C, 
and d is for .D; all non-null arguments must be 
dimensioned; null arguments leave the 
corresponding spacing unaffected; initial setting is: 


DV 5v 5v 5v Ov 
.U str? [str2] Underline str? and concatenate str2 (if any) to it. 


The last four macros in the above list do not cause a break: the .l 
macro causes a break only if it is invoked with more than one argu- 
ment: all the other macros cause a break. 


The macro package also recognizes the following upper-case 
synonyms for the corresponding lower-case troff requests: 
AD BR CE FI HY NA NF NH NX SO SP TA TI 


The Tm string produces the trademark symbol. 
The input tilde (~) character is translated into a blank on output. 
See the user’s manual cited below for further details. 


FILES 
/usr/lib/tmac/tmac.v 
/ust/ib/macros/vmca 

SEE ALSO 
eqn(1), mmt(1), tbl(1), troff(1). 

BUGS | i 
The .VW and .SW foils are meant to be 9’’ wide by 7”’ high, but 
because the typesetter paper is generally only 8’’ wide, they are 
printed 7’’ wide by 5.4’’ high and have to be enlarged by a factor of 
9/7 before use as viewgraphs; this makes them less than totally 
useful. 
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NAME 
prof — profile within a function Pa 


SYNOPSIS | : oe Kc, 
#define MARK 
#include <prof.h> 


void MARK (name) 


DESCRIPTION 
MARK will introduce a mark called name that will be treated the 
same as a function entry point. Execution of the mark will add to a 
counter for that mark, and program-counter time spent will be 
accounted to the immediately preceding mark or to the function if 
there are no preceding marks within the active function. 


Name may be any combination of up to six letters, numbers or 
underscores. Each name in a single compilation must be unique, 
but may be the same as any ordinary program symbol. 


The symbol MARK must be defined before the header file prof.h is 
included. It can be defined by a preprocessor directive as in the 
synopsis, or by a command line argument, such as: 


cc —p —DMARK foo.c 


If MARK is not defined, the MARK (name) statements may be left in’ ~~. 
the source files containing them and will be ignored. 


EXAMPLE 7 
In this example, marks can be used to determine how much time is 
spent in each loop. Unless this example is compiled with MARK 
defined on the command line, the marks are ignored. 
#include <prof.h> 
foo( ) 
int i, j; 
MARK (loop1); 
for (i = 0; i < 2000; i++) { 
MARK(loop2); 
for (j = 0; j < 2000; j++) { oe 
oe e 
} 
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SEE ALSO 


-_ profil(2), monitor(3C). 
= prof(1) in the Sys5 UNIX User Reference Manual. 


( | 
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NAME 


DESCRIPTION | es ee 


FILES 


profile — setting up an environment at login time = | Gre 


lf your login directory contains a file named .profile, that file will be 
executed (via the shell’s exec .profile) before your session begins; 
-profiles are handy for setting exported environment variables and 
terminal modes. If the file /etc/profile exists, it will be executed for 
every user before the .profile. The following example is typical 
(except for the comments): 


# Make some environment variables globa 

export MAIL PATH TERM LOGNAME 

# Set file creation mask 

umask 22 

# Tell me when new mail comes in 

MAIL =/usr/mail/myname 

# Add my /bin directory to the shell se 

PATH= $PATH:$HOME/bin 

# Set terminal type 

echo "terminal: \c” 

read TERM 

case $TERM in 7 
300) stty cr2 nl0 tabs; tabs;; a 
300s) stty cr2 nl0 tabs; tabs;; ee 
450) stty cr2 nl0O tabs; tabs;; 
hp) stty crO nlO tabs; tabs;; 
745 |735) _ stty cr1 nl1 -tabs; TERM=745;; 
43) stty cr1 niO —tabs;; 
4014 |tek) stty crO nlO -tabs ff1; TERM=4014; echo '\33;'; 
2 echo "$TERM unknown"; 

esac 


SHOME/.profile 
/etc/profile 


SEE ALSO 
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env(1), login(1), mail(1), sh(1), stty(1), su(1), environ(7), term(7). 


[ 
\ 
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NAME 


regexp — regular expression compile and match routines 


- SYNOPSIS 


#define INIT <declarations> 

#define GETC() <getc code> 

#define PEEKC() <peekc code> 
#define UNGETC(c) <ungetc code> 
#define RETURN(pointer) <return code> 
#define ERROR(val) <error code> 


#include <regexp.h> 


char *compile (instring, expbuf, endbuf, eof) 
char *instring, =expbuf, +endbuf; 
int eof; 


int step (string, expbuf) 
char +*string, *expbuf; 


extern char *loc1, *loc2, *locs; 
extern int circf, sed, nbra; 


DESCRIPTION 
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This page describes general-purpose regular expression matching 
routines in the form of ed (7), defined in /usr/include/regexp.h . 
Programs such as ed (1), sed (1), grep (1), bs (1), expr (1), etc., 
which perform regular expression matching use this source file. In 
this way, only this file need be changed to maintain regular expres- 
sion compatibility. 


The interface to this file is unpleasantly complex. Programs that 
include this file must have the following five macros declared before 
the “#include <regexp.h>" statement. These macros are used by 
the compile routine. 


GETC( ) Return the value of the next character in the 
regular expression pattern. Successive calls 
to GETC() should return successive charac- 
ters of the regular expression. 


PEEKC() Return the next character in the regular 
expression. Successive calls to PEEKC() 
should return the same character (which 
should also be the next character returned by 
GETC()). 


UNGETC(c ) Cause the argument c to be returned by the 
next call to GETC() (and PEEKC()). No more 
that one character of pushback is ever 
needed and this character is guaranteed to 
be the last character read by GETC(). The 
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value of the macro UNGETC( c ) is always 
ignored. 


RETURN( pointer ) This macro is used on normal exit of the 
compile routine. The value of the argument 
pointer is a pointer to the character after the 
last character of the compiled regular expres- 
sion. This is useful to programs which have 
memory allocation to manage. 


ERROR( val ) This is the abnormal return from the compile 
routine. The argument va/ is an error number 
(see table below for meanings). This call 
should never return. 


ERROR MEANING 

11 Range endpoint too large. 

16 - Bad number. 

25 ‘\digit” out of range. 

36 Illegal or missing delimiter. 

41 No remembered search string. 

42 \( \) imbalance. 

43 Too many \(. 

44 More than 2 numbers given in \{ \}. 
45 } expected after \. | 

46 First number exceeds second in \{ \}. 
49 [ ] imbalance. | 

90 Regular expression overflow. 


The syntax of the compile routine is as follows: 
compile(instring, expbuf, endbuf, eof) 


The first parameter instring is never used explicitly by the compile 
routine but is useful for programs that pass down different pointers 
to input characters. It is sometimes used in the INIT declaration 
(see below). Programs which call functions to input characters or 
have characters in an external array can pass down a value of 
((char *) 0) for this parameter. 


The next parameter expbuf is a character pointer. It points to the 
place where the compiled regular expression will be placed. 


The parameter endbuf is one more than the highest address where 
the compiled regular expression may be placed. If the compiled 
expression cannot fit in ( endbuf — expbuf ) bytes, a call to 
ERROR(50) is made. 


The parameter eof is the character that marks the end of the regular 
expression. For example, in ed (7), this character is usually "/". 
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Each program that includes this file must have a #define statement 
for INIT. This definition will be placed right after the declaration for 
the function compile and the opening curly brace ({). It is used for 
dependent declarations and initializations. Most often it is used to 
set a register variable to point the beginning of the regular expres- 
sion so that this register variable can be used in the declarations for 
GETC(), PEEKC() and UNGETC(). Otherwise it can be used to 
declare external variables that might be used by GETC(), PEEKC() 
and UNGETC(). See the example below of the declarations taken 
from grep (1). 


There are other functions in this file which perform actual regular 
expression matching, one of which ts the function step . The call to 
step is as follows: 


step(string, expbuf) 


The first parameter to step is a pointer to a string of characters to 
be checked for a match. This string should be null terminated. 


The second parameter expbuf is the compiled regular expression 
which was obtained by a call of the function compile . 


The function sfep returns non-zero if the given string matches the 
_ regular expression, and zero if the expressions do not match. If 
( there is a match, two external character pointers are set as a side 
| effect to the call to step . The variable set in step is loc? . This is a 
pointer to the first character that matched the regular expression. 
The variable /oc2 , which is set by the function advance , points to 
the character after the last character that matches the regular 
expression. Thus if the regular expression matches the entire line, 
foc? will point to the first character of string and /oc2 will point to 

the null at the end of string . 


Step uses the external variable circf which is set by compile if the 
regular expression begins with * . If this is set then step will try to 
match the regular expression to the beginning of the string only. If 
more than one regular expression is to be compiled before the first 
is executed the value of circf should be saved for each compiled 
expression and circf should be set to that saved value before each 
call to step. 


The function advance is called from step with the same arguments 

as step . The purpose of step is to step through the string argu- 

ment and call advance until advance returns non-zero indicating a 

match or until the end of string is reached. If one wants to con- 

ah strain string to the beginning of the line in all cases, step need not 
( " be called; simply call advance . 


When advance encounters a * or \{ \} Sequence in the regular 
expression, it will advance its pointer to the string to be matched as 
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far as possible and will recursively call itself trying to match the rest 

of the string to the rest of the regular expression. As long as there ~ 
is No match, advance will back up along the string until it finds al 
match or reaches the point in the string that initially matched the + 

or \{ \}. It is sometimes desirable to stop this backing up before the 
initial point in the string is reached. If the external. character pointer 

locs is equal to the point in the string at sometime during the back- 

ing up process, advance will break out of the loop that backs up 

and will return zero. This is used by ed (7) and sed (7) for substitu- 
tions done globally (not just the first occurrence, but the whole line) 

so, for example, expressions like s/y*//g do not loop forever. 


The additional external variables sed and nbra are used for special 
purposes. | 


EXAMPLES 
The following is an example of how the regular expression macros 
and calls look from grep (1): 


#define INIT register char *sp = instring; 

#define GETC() («sp+-+) : 

#define PEEKC() (*Sp) 

#define UNGETC(c) (—sp) 

#define RETURN(c). ~ return; yee 
#define ERROR(c) regerr() | 


#include <regexp.h> 


(void) compile(*argv, expbuf, &expbuf[ESIZE], °0’); 


if (step(linebuf, expbuf)) 


succeed( ); © 


FILES 
/usr/include/regexp.h 


SEE ALSO | | 
bs(1), ed(1), expr(1), grep(1), sed(1) in the Sys5 UNIX User Refer- 
ence Manual. | 3 
BUGS | 3 | 
The handling of circf is kludgy. The actual code is probably easier 
to understand than this manual page. | 
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NAME 


stat — data returned by stat system call 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/stat.h> — 


DESCRIPTION 


The system calls stat and fstat return data whose structure is 
defined by this include file. The encoding of the field st_mode is 
defined in this file also. 


y* 


* Structure of the result of stat 


*/ 


struct 


‘e 


#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 


FILES 


stat 


dev_t 
ino_t 
ushort 
short 
ushort 
ushort 
dev_t 
off_t 
time_t 
time_t 
time_t 


S_IFMT 
S_IFDIR 
S_IFCHR 
S_IFBLK 
S_IFREG 
S_IFIFO 
S_ISUID 
S_ISGID 
S_ISVTX 
S_IREAD 
S_IWRITE 
S_IEXEC 


st_dev; 
st_ino; 
st_mode; 
st_nlink; 
st_uid; 
st_gid; 
st_rdev; 
st_size; 
st_atime; 
st_mtime;: 
st_ctime; 


0170000 
0040000 
0020000 
0060000 
0100000 
0010000 
04000 
02000 
01000 
00400 
00200 
00100 


/usr/include/sys/types.h 
/usr/include/sys/stat.h 


Page 1 


/* type of file */ 

/* directory */ 

/* Character special «/ 

/* block special «/ 

/* regular */ 

/* fifo */ 

/* set user id on execution */ 

/* set group id on execution */ 

/* save Swapped text even after use */ 
/* read permission, owner */ 

/* write permission, owner */ 

/* execute/search permission, owner */ 
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EE ALSO ) 
. stat(2), types(5). 
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term — conventional names for terminals 


DESCRIPTION 
These names are used by certain commands (e.g., fabs (1) , man 
(1) and are maintained as part of the shell environment (see sh (7), 
profile (4), and environ (5)) in the variable $TERM : 


1520 
1620 
1620-12 
2621 
2631 
2631-—c 
2631-e 
2640 
2645 
300 


Datamedia 1520 

DIABLO 1620 and others using the HyType I! printer 
same, in 12-pitch mode 

Hewlett-Packard HP2621 series 

Hewlett-Packard 2631 line printer 

Hewlett-Packard 2631 line printer - compressed mode 
Hewlett-Packard 2631 line printer - expanded mode 
Hewlett-Packard HP2640 series 

Hewlett-Packard HP264n series (other than the 2640 series) 
DASI/DTC/GSI 300 and others using the HyType | printer 
same, in 12-pitch mode 

DASI/DTC/GSI 300s | 

DTC 382 

same, in 12-pitch mode 

Datamedia 3045 

TELETYPE® Model 33 KSR 

TELETYPE Model 37 KSR 

TELETYPE Model 40/2 

TELETYPE Model 40/4 

TELETYPE Model 4540 

IBM Model 3270 

Trendata 4000a 

TEKTRONIX 4014 

TELETYPE Model 43 KSR 

DASI 450 (same as Diablo 1620) 

same, in 12-pitch mode 

Texas Instruments T1735 and TI725 

Texas Instruments T1745 

generic name for terminals that lack reverse 
line-feed and other special escape sequences 
generic name for synchronous TELETYPE 
4540-compatible terminals 

Hewlett-Packard (same as 2645) 

generic name for a line printer 

User Electric TermiNet 1200 

User Electric TermiNet 300 


Up to 8 characters, chosen from [-a—z0—9], make up a basic termi- 
nal name. Terminal sub-models and operational modes are dis- 
tinguished by suffixes beginning with a -. Names should generally 
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be based on original vendors, rather than local distributors. A termi- 
nal acquired from one vendor should not have more than one dis- 
tinct basic name. 


Commands whose behavior depends on the type of terminal should 
accept arguments of the form —T term where term is one of the 
names given above; if no such argument is present, such com- 
mands should obtain the terminal type from the environment vari- 
able $TERM , which, in turn, should contain term . 


SEE ALSO 


BUGS 


profile(4), environ(5). 
man(1), mm(1), nroff(1), sh(1), stty(1), tabs(1), tplot(1G) in the Sys5 
UNIX User’s Reference Manual. 


This is a small candle trying to illuminate a large, dark problem. 
Programs that ought to adhere to this nomenclature do so some- 
what fitfully. 


August 8, 1986 | Page 2 


¢ 


NAME 


TROFF(5) UNIX Sys5 TROFF(5) 


Page 1 


troff — description of output language 


. - DESCRIPTION 


The device-independent troff outputs a pure ASCII description of a 
typeset document. The description specifies the typesetting device, 
the fonts, and the point sizes of characters to be used as well as the 
position of each character on the page. A list of all the legal com- 
mands follows Most numbers are denoted as n and are ASCII 
strings. Strings inside of [ ] are optional. Troff may produce them, 
but they are not required for the specification of the language. The 
character \n has the standard meaning of “newline” character. 
Between commands white space has no meaning. White space 
characters are spaces and newlines. All commands which have an 
arbitrary length numericai parameter or word must be followed by 


white space. For example, the command to specify point size, 


s###, must be followed by a space or newline. 


sn The point size of the characters to be gen- 
erated. 
fn The font mounted in the specified position is to 


be used. The number ranges from 0 to the 
highest font presently mounted. O is a special 
position, invoked by troff, but not directly acces- 
sible to the troff user. Normally fonts are 
mounted starting at position 1. 


cx Generate the character x at the current location 
on the page; x is a single ASCII character. 


Cxyz Generate the special character xyz. The name 
of the character is delimited by white space. 
The name will be one of the special characters 
legal for the typesetting device as specified by 
the device specification found in the file DESC. 
This file resides in a directory specific for the 
typesetting device. (See  font(5) and 
/usr/lib/font/dev*.) 


Hn Change the horizonal position on the page to 
the number specified. The number is in basic 
units of motions as specified by DESC . This is 
an absolute “goto”. 


hn Add the number specified to the current hor- — 
izontal position. This is a relative “goto”. 


Vn Change the vertical position on the page to the 
number specified (down is positive). 
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vn 


_ nx 


nb a 


pn 


} 


tXXXXX 


# .... \n 


Di x y\n 


De d\n 
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Add the number specified to the current vertical 
position. 


j 


ero, 


This is a two-digit number followed by an ASCII MO 


character. The meaning is a combination of hn 
followed by cx. The two digits nn are added to 
the current horizontal position and then the 
ASCII character, x, is produced. This is the 
most common form of character specification. 


This command indicates that the end of a line 
has been reached. No action is _ required, 
though by convention the horizontal position is 
set to 0. Troff will specify a resetting of the x, y 
coordinates on the page before requesting that 
more characters be printed. The first number, 
b, is the amount of space before the line and 
the second number, a, the amount of space 
after the line. The second number is delimited 
by white space. 


A w appears between words of the input docu- 
ment. No action is required. It is included so 
that one device can be emulated more easily on 
another device. 


Begin a new page. The new page number is 
included in this command. The vertical position 
on the page should be set to 0. 


Push the current environment, which means 
saving the current point size, font, and location 
on the page. 


Pop a saved environment. 


Print the string of characters, xxxxx , using the 
natural width of each character to determine the 
next x coordinate. Troff does not currently pro- 


duce this form of command. It is not recom- 


mended. The characters will propaply be too 
close together. 


A line beginning with a pound sign is a com- 
ment. 


Draw a line from the current location to x, y. At 
the end of the drawing operation the current 
location will be x, y. 


Draw a circle of diameter d with the leftmost 
edge being at the current location (x, y). The 
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De dx dy\n 


Da x y r\n 


D xyxy...\n 


x i{nit]\n 


x T device\n 


x r[es] 2 A v\n 


x p[ause]\n 


x s[top]\n 


x t[railer]\n 
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current location after drawing the circle will be 
x+d,y, the rightmost edge of the circle. 


Draw an ellipse with the specified axes. dx is 
the axis in the x direction and dy is the axis in 
the y direction. The leftmost edge of the ellipse 
will be at the current location. After drawing the 
ellipse the current location will be x+dx,y. 


Draw a counterclockwise arc from the current 
location to x, y using a circle of radius r. The 
current location after drawing the arc will be x, 
y. 

Draw a spline curve (wiggly line) between each 
of the x, y coordinate pairs starting at the 
current location. The final location will be the 
final x, y pair of the list. Currently there may be 
no more than 36 x, y pairs to this command. 


Initialize the typesetting device. The actions 
required are dependent on the device. An init 
command will always occur before any output 
generation is attempted. 


The name of the typesetter is device . This is 
the same as the argument to the —T option. 
The information about the typesetter will be 
found in the directory /usr/lib/font/dev{device}. 


The resolution of the typesetting device in incre- 
ments per inch is n . Motion in the horizontal 
direction can take place in units of A basic 
increments. Motion in the vertical direction can 
take place in units of v basic increments. For 
example, the APS-5 typesetter has a basic 
resolution of 723 increments per inch and can 
move in either direction in 723rds of an inch. 
Its specification is: 

x res 723 1 1 


Pause. Cause the current page to finish but do 
not relinquish the typesetter. 


Stop. Cause the current page to finish and 
then relinquish the typesetter. Perform any 
shutdown and bookkeeping procedures 
required. 


Generate a trailer. On some devices no opera- 
tion is performed. 
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x f[ont] 7 name\n Load the font name into position n. 


x Hfeight] n\n 


x Slant} n\n 


September 19, 1986 


Set the character height to n points. This ~ ~ 
causes the letters to be elongated or shortened. \_- 
It does not affect the width of a letter. 


Set the slant to n degrees. Only some 
typesetters can do this and not all angles are 
supported. 
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NAME 
é ttytype - data base of terminal types by port 


__ SYNOPSIS 
/etc/ttytype 


DESCRIPTION | a 
Ttytype is a database containing, for each TTY port on the system, 
the kind of terminal that is attached to it. The terminal kinds are 
from the names listed in termcap(5). Each port description occu- 
pies one line. The line contains the terminal kind, a space, and the 
name of the TTY, minus the /dev prefix. A sample ttytype file looks 
like this: 7 


vt100 console 
adm3a ttyO 
vt100 tty1 
vt52 tty2 
vt100 tty3 
vt100 tty4 
dm1520 tty5 
vt100 tty6 
vt100 tty7 


( | This information is used by tset(1) and /ogin(1) to initialize the TERM 
6 variable at login time. — 


SEE ALSO 
tset(1), login(1). 
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NAME a 
types — primitive system data types ia 
SYNOPSIS | a, 
#include <sys/types.h> 
DESCRIPTION | 
The data types defined in the include file are used in UNIX system 
code; some data of these types are accessible to user code: 
typedef struct { int r[1]; } * -  physadr; 
typedef long daddr_t; _ 
typedef char caddr_t; 
typedef unsigned int __uint; 
typedef unsigned short ushort; 
typedef ushort ino_t; 
typedef short cnt_t; 
typedef long time_t; 
typedef int label_t[10]; 
typedef short dev_t; 
typedef long off_t; 
typedef long paddr_t; 
typedef long key_t; 
The form dadadr_t is used for disk addresses except in an i-node on ~— 
disk, see fs (4). Times are encoded in seconds since 00:00:00 GMT, es 
January 1, 1970. The major and minor parts of a device code — 
specify kind and unit number of a device and are installation- 
dependent. Offsets are measured in bytes from the beginning of a 
file. The /abe/l_t variables are used to save the processor state 
while another process is running. 
SEE ALSO 


fs(4). 
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_ NAME 


UNIX Sys5 VALUES(5) 


values — machine-dependent values 


~ SYNOPSIS 


#include <values.h> 


DESCRIPTION 


This file contains a set of manifest constants, conditionally defined 
for particular processor architectures. 


The model assumed for integers is binary representation (one’s or 
two's complement), where the sign is represented by the value of 


_-the high-order bit. 
BITS( type ) 


- HIBITS 
HIBITL | 
HIBITI 


_ MAXSHORT 


MAXLONG 


MAXINT 


The number of bits in a specified type (e.g., 
int). 


The value of a short integer with only the 
high-order bit set (in most implementations, 
0x8000). 


The value of a long integer with only the 
high-order bit set (in most implementations, 
0x80000000). 


The value of a regular integer with only the 
high-order bit set (usually the same as HIBITS 
or HIBITL). 


The maximum value of a signed short integer 
(in most implementations, Ox7FFF = 32767). 


The maximum value of a signed long integer 
(in most implementations, Ox7FFFFFFF = 
2147483647). 


The maximum value of a signed regular 
integer (usually the same as MAXSHORT or 
MAXLONG). | 


MAXFLOAT, LN_MAXFLOAT The maximum value of a single- 


precision floating-point number, 
and its natural logarithm. 


MAXDOUBLE, LN_MAXDOUBLE The maximum value of a double- 


precision floating-point number, 
and its natural logarithm. 


MINFLOAT, LN_MINFLOAT The minimum positive value of a 


single-precision floating-point 
number, and its natural logarithm. 
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MINDOUBLE, LN_MINDOUBLE The minimum positive value of a 
double-precision floating-point ; 
number, and its natural logarithm. “—~ 


a. 


FSIGNIF The number of significant bits in the ‘mantissa 
of a single-precision floating-point number... 
DSIGNIF The number of significant bits in the mantissa 
of a double-precision floating-point number. 
FILES a 
_ /usr/include/values.h 
SEE ALSO 


intro(3), math(5). 


\ 
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_ NAME 
varargs — handle variable argument list 


SYNOPSIS 
#include <varargs.h> 


va_alist 

va_decl 

void va_start(pvar) 

va_list pvar; 

type va_arg(pvar, type) 

va_list pvar; 

void va_end(pvar) 

va_list pvar; 
DESCRIPTION 


This set of macros allows portable procedures that accept variable 
argument lists to be written. Routines that have variable argument 
lists (such as printf (3S)) but do not use varargs are inherently non- 
portable, as different machines use different argument-passing con- 


ventions. 
a va_alist is used as the parameter list in.a function header. 
( va_dcl is a declaration for va_alist . No semicolon should follow 


va_dcil. 
va_list is a type defined for the variable used to traverse the list. 
va_Start is called to initialize pvar to the beginning of the list. 


va_arg will return the next argument in the list pointed to by pvar . 
Type is the type the argument is expected to be. Different types 
can be mixed, but it is up to the routine to know what type of argu- 
ment is expected, as it cannot be determined at runtime. 


va_end is used to clean up. 


Multiple traversals, each bracketed by va _start .. . Va_end, are pos- 
sible. 
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EXAMPLE | | | | | 
This example is a possible implementation of exec! (2). fo a 
#include <varargs.h> a | ee 
_ #define MAXARGS 100 | 
[x execl is called by 
execi(file, arg1, arg2, ..., (char «)Q); 
se / 7 | 
execi(va_alist) 
va_dcl 
fo 
va_list ap; 
char «file; | 
char «args[MAXARGS]; 
int argno = Q; 
va_start(ap); 
file = va_arg(ap, char *); - 
while ((args[argno+ ss = va_arg(ap, shar «)) != (char #)O) 
va_end(ap): | —— 
return execv(file, args); we 
} | fc 
SEE ALSO 
| — exec(2), printf(3S). 
BUGS ; 3 7 ee 
It is up to the calling routine to specify how many arguments there — 
are, since it is not always possible to determine this from the stack — 
_ frame. For example, exec/ is passed a zero pointer to signal the 
end of the list. Printf can tell how many arguments are there by the 
_ format. | 
It is non- portable to specify a second argument of char , short , or 
float to va_arg , since arguments seen by the called function are not 
char , short , or float . C converts char and short arguments to int 
and converts float arguments to double before passing them to a 
function. 
a 
Nc. 
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